Sign in

v10

latestOpenAPI 3.1.02026-08-0375143791.1 KB
webdbs

Create a webhook

Creates a webhook for row and run events. Use the returned secret to verify signatures.

post/webdbs/webhooks

Request body

urlstring uri required

HTTPS URL that receives events.

eventsstring[] required

Events sent to this webhook.

collection_idstring

Collection to watch. Omit to watch all collections.

delivery'instant' | 'batch'

Send events immediately or in batches.

tagsstring[]

Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.

Example request

{
  "tags": [
    "production",
    "team-alpha"
  ]
}

Response

Webhook created

idstring required

Webhook ID.

urlstring uri required

HTTPS URL that receives events.

eventsstring[] required

Events sent to this webhook.

collection_idstring nullable required

Collection being watched, or null for all collections.

delivery'instant' | 'batch' required

Whether events are sent immediately or in batches.

secretstring required

Secret used to verify webhook signatures.

status'active' | 'disabled' required

Current webhook status.

created_atstring date-time required

Time the webhook was created.

updated_atstring date-time required

Time the webhook was last updated.

Example response

{
  "id": "wh_123"
}