Register a webhook endpoint

POST

/webhooks

Webhook Endpoints

Last modified:2026-06-05 10:12:55

Maintainer:Not configured

Creates a new webhook endpoint. The signing_secret is returned once — store it immediately. It cannot be retrieved again (only rotated).

If events is omitted, all available events are subscribed by default.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Endpoint created. The signing_secret is shown here only — store it now.

Bodyapplication/json

🟠401Unauthorized

🟠422UnprocessableEntity

Request Example

Shell

JavaScript

Java

Swift

curl --location '/webhooks' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Production Handler",
    "url": "https://your-server.com/webhooks/tdta",
    "events": [
        "booking.created",
        "booking.confirmed",
        "booking.cancelled"
    ],
    "timeout_seconds": 10
}'

Response Example

201 - Success

{
    "id": 3,
    "name": "Production Handler",
    "url": "https://your-server.com/webhooks/tdta",
    "events": [
        "booking.created",
        "booking.confirmed",
        "booking.cancelled"
    ],
    "is_active": true,
    "timeout_seconds": 10,
    "secret_prefix": "tdtaXyZ1abcd••••••••••••••••••••",
    "last_delivered_at": null,
    "last_response_code": null,
    "consecutive_failures": 0,
    "created_at": "2026-06-05T10:00:00+00:00",
    "signing_secret": "tdtaXyZ1abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqrstu",
    "signing_secret_notice": "Store this secret safely — it will not be shown again."
}

Modified at 2026-06-05 10:12:55

List webhook endpoints

Get a webhook endpoint