Docs
OverviewGuidesZero & MCPAPI referenceChangelog
Webhooks

List Webhook Deliveries

The endpoint's delivery log, newest first. Deliveries are deleted after `WEBHOOKS_DELIVERY_RETENTION_DAYS` (default 30).

API key access

Needs the admin scope with an API key (ro_pat_...). A signed-in session uses the caller's role.
GET/api/v1/webhook-endpoints/{endpoint_id}/deliveries

Authorization

AuthorizationBearer <token>

Access token from /api/v1/auth/login, or an API key (ro_pat_..., RO-176) from /api/v1/workspaces/current/api-keys: the key implies its workspace and needs the route's scope. MCP connectors (/api/v1/mcp only) may use an OAuth access token (ro_oat_..., RO-284).

In: header

Path Parameters

endpoint_idstring
Formatuuid

Query Parameters

status?WebhookDeliveryStatus | null
event_type?string | null
limit?integer

Default 50

Formatint64
Range1 <= value <= 200
cursor?string | null

next_cursor of the previous page

Header Parameters

X-Workspace-Id?string | null

Id of the workspace to act on (must be a member).

Response Body

curl -X GET "http://localhost:8000/api/v1/webhook-endpoints/497f6eca-6276-4993-bfeb-53cbbbba6f08/deliveries?event_type=string&limit=1&cursor=string" \  -H "X-Workspace-Id: string"
{
  "items": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "endpoint_id": "e9ce0d4f-d433-423d-9497-4c000544106c",
      "event_id": "a7a26ff2-e851-45b6-9634-d595f45458b7",
      "event_type": "call.completed",
      "status": "pending",
      "attempts": 0,
      "last_status_code": 0,
      "last_error": "string",
      "last_response": "string",
      "last_duration_ms": 0,
      "last_attempt_at": "2019-08-24T14:15:22Z",
      "next_attempt_at": "2019-08-24T14:15:22Z",
      "completed_at": "2019-08-24T14:15:22Z",
      "replay_of": "eb051ed0-925f-449a-a6c5-0c118d499f91",
      "is_test": true,
      "created_at": "2019-08-24T14:15:22Z",
      "payload": {
        "property1": null,
        "property2": null
      }
    }
  ],
  "next_cursor": "string"
}
Empty
Empty
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Lead Webhook

Ingest a lead from a form or integration (`Authorization: Bearer <webhook key>`). Upserts the lead (by email, else phone), records `phone_consent` if given, and, when speed-to-lead is on and every compliance check passes, queues an AI call (or schedules it for the next calling-window time). Every outcome is on the lead's timeline (`speed_to_lead`). Send an `Idempotency-Key` header to name the delivery (default: the body); a replay returns the first result and never calls twice.

List Webhook Endpoints

The workspace's webhook endpoints, newest first, and every event type they can subscribe to. Admins and owners (or a key with `admin`).