Webhook-Delivery

Ingest a webhook event

POST /ingest/{subscription_id}
Hub signature

Accept an event for a specific subscription. Requires HMAC signature and event type headers if the subscription is configured with a secret.

Headers

  • X-Event-Type string

    The type of event being delivered (e.g., order.created).

  • X-Hub-Signature-256 string

    HMAC SHA256 signature of the request body, prefixed with "sha256=".

Path parameters

  • subscription_id string(uuid) Required

    Subscription ID (UUID)

application/json

Body Required

object object

Arbitrary event payload.

Responses

  • 202

    Webhook accepted for delivery.

  • 400

    Invalid request (e.g., missing required headers for a secured subscription, malformed payload).

  • 401

    Invalid signature.

  • 404 application/json

    The requested resource was not found.

    Hide response attribute Show response attribute object
    • error string
  • 500 application/json

    An unexpected error occurred on the server.

    Hide response attribute Show response attribute object
    • error string
POST /ingest/{subscription_id} 
curl \
 --request POST 'http://localhost:8080/ingest/{subscription_id}' \
 --header "Content-Type: application/json" \
 --header "X-Event-Type: string" \
 --header "X-Hub-Signature-256: string" \
 --data '{"data":{"id":"123","amount":42},"event":"order.created"}'
Request example 
{
  "data": {
    "id": "123",
    "amount": 42
  },
  "event": "order.created"
}
Response examples (404) 
{
  "error": "string"
}
Response examples (500) 
{
  "error": "string"
}