How Webhooks Work

To understand webhooks, you gotta understand the web.

1 / 7
1

How Webhooks Work

To understand webhooks, you gotta understand the web.

2

HTTP (Hyper Text Transfer Protocol)

HTTP powers virtually everything you do online. From company’s perspective it means the following…

  • It is how users interact with our app
  • Virtually all third-party integrations use it
  • It is how webhooks work!
  • … even this slide presentation is delivered over HTTP
3

Send Request, Receive Response

A diagram showing how HTTP requests work
4

Webhooks Are About The Request

  • The Request is what we send to our customers
  • The Response is our customer telling us whether they processed what we sent them
  • Webhooks are asynchronous
5

What Requests Look like

POST /tenant/webhook HTTP/1.1
Content-Type: application/json
User-Agent: Company Webhook Server
Webhook-Request-Id: YYYYYYYYYY
Webhook-Signature: XXXXXXXXXX
Webhook-Timestamp: 2022-08-22 09:04:00

{"some": "data"}
POST /tenant/webhook HTTP/1.1
Content-Type: application/json
User-Agent: Company Webhook Server
Webhook-Request-Id: YYYYYYYYYY
Webhook-Signature: XXXXXXXXXX
Webhook-Timestamp: 2022-08-22 09:04:00

{"some": "data"}
6
7