v1

latestOpenAPI 3.0.32026-07-264955102.7 KB

Webhooks

Create webhook

Creates a webhook endpoint subscribed to one or more event topics. The signing_secret is returned only in this response — store it to verify delivery signatures.

post/v2/api/webhooks

Request body

urlstring uri required

HTTPS URL that will receive event deliveries.

topicsWebhookTopic[] required

Event topics to subscribe to (at least one).

descriptionstring

Optional human-readable label.

Example request

{
  "topics": [
    "call.received"
  ]
}

Response

Webhook created

Example response

{
  "data": {
    "id": "ep_2NfDKEm9sF8xK3pQr1Zt",
    "topics": [
      "call.received"
    ]
  }
}