WIwithallo
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

  • Base URL
    https://api.withallo.com
  • URL
    https://api.withallo.com/v2/api/webhooks
  • Auth
    API key in header Authorization

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"
    ]
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.