Back to Category

Setting Up Webhooks

  1. Go to Settings → Webhooks tab.
  2. Enter your callback URL (must start with http:// or https://).
  3. Select one or more events to subscribe to: message.sent, message.delivered, message.failed, message.received, or message.expired.
  4. Optionally select specific phone numbers to filter by. If none are selected, the webhook fires for all phones.
  5. Click Create Webhook. A signing key is generated and hidden by default. Click Show to reveal it.
  6. To edit a webhook, click Edit. You can update the URL, events, and phone filters without losing the signing key.
  7. To regenerate a signing key, click Edit → Regenerate signing key. The old key is invalidated and a new one is generated.
  8. To delete a webhook, click Delete and confirm.

Tip: Use the signing key to verify webhook payloads by checking the signature header. If your signing key is compromised, regenerate it immediately from the edit form.

Related Articles