Docs
Get an API key
Hotel webhooks

Change a subscription

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

You 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. 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

curl -X PATCH "https://example.com/v1/hotel/webhook-subscriptions/string" \  -H "Content-Type: application/json" \  -d '{}'
{  "data": {    "id": "string",    "url": "string",    "event_types": [      "hotel.booking.confirmed"    ],    "status": "ACTIVE",    "previous_secret_expires_at": "2019-08-24T14:15:22Z",    "created_at": "2019-08-24T14:15:22Z",    "updated_at": "2019-08-24T14:15:22Z"  }}

Create a subscription POST

You register an HTTPS endpoint and the events it receives. You receive the signing secret only in this response; store it on your server. Your organization holds at most five subscriptions, one per URL, shared by all its credentials.

Delete a subscription DELETE

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