Docs
Get an API key
Flight Webhooks

Change a subscription

PATCH
/v1/flight/webhook-subscriptions/{id}

Change the URL, the events or the status. A paused subscription receives no new events, and events that occur while it is paused are not sent later. Events not yet queued when you pause fail with subscription_paused; resume the subscription, then replay them. Requests already queued, including their retries, still arrive at the URL they were queued with.

Authorization

x-api-key<token>

Your API key. Issued and revoked from the TrustPixel dashboard; the gateway resolves it to an owning organization on every request.

In: header

Path Parameters

id*string
Match^whs_[a-zA-Z0-9-]+$
Lengthlength <= 128

Header Parameters

x-request-id?string

Correlation id echoed to the upstream service and returned on the response. Generated as req_<uuid> when omitted.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/v1/flight/webhook-subscriptions/whs_0192f3a4b5c64d7e8f9a0b1c2d3e4f5b" \  -H "Content-Type: application/json" \  -d '{}'
{  "data": {    "id": "whs_0192f3a4b5c64d7e8f9a0b1c2d3e4f5b",    "url": "https://partner.example/hooks/flight",    "event_types": [      "flight.booking.confirmed"    ],    "status": "ACTIVE",    "previous_secret_expires_at": "string",    "created_at": "string",    "updated_at": "string"  }}

Create a subscription POST

Register an HTTPS endpoint and the events it receives. You receive the signing secret only in this response, so store it on your server. Your organisation holds at most five subscriptions, one per URL, shared by all its credentials; a sixth or a repeated URL is a `409`.

Delete a subscription DELETE

Delete the subscription and its delivery history. Requests already queued can still arrive.