Skip to main content

Get your notification URL

GET 
/api/v1/tenants/me/webhook

Returns the URL currently registered for your account, or null if you are not subscribed.

We send a POST to this URL when one of your campaigns ends (campaign_done) and when your credit falls below its alert threshold (low_credit). One URL per account — it receives every event type, so route on the event field.

The body looks like this:

{
  "tenantId": "8a1f…",
  "timestamp": "2026-09-01T14:22:07Z",
  "event": "campaign_done",
  "title": "Campagne terminée",
  "body": "La campagne \"September payment reminder\" est terminée",
  "payload": {
    "campaignId": "c1d2e3f4-…",
    "name": "September payment reminder",
    "stats": { "total": 1500, "answered": 1120, "no-answer": 310, "busy": 45, "failed": 25 }
  }
}

payload.campaignId is the identifier returned by the voice push or campaign endpoints, which is how you match a notification to the job you started.

Before relying on it: the call is made once, with no retry and a 5-second timeout, so a notification can be lost if your server is down at that moment; it is not signed, so treat the URL as a secret and re-check state with GET /api/v1/campaigns/{id}; and your response code is ignored — answer 200 quickly and process asynchronously.

The webhook is an accelerator, not a delivery guarantee. Use it to react fast, and keep a periodic check of your campaigns as a safety net.

Responses​

The registered URL.