List webhook deliveries

This page documents the canonical HTTP contract. Switch to the CLI example when you want the operator workflow.

Results are organization-scoped, newest first. Delivery statuses include queued, retry_scheduled, succeeded, and failed. The count is the number returned after filtering and limiting, not a total count across pages.

Query parameters

subscriptionId · optional
string
Filter by subscription id.
status · optional
string
Exact status filter, normalized to lowercase; values are not separately validated.
eventType · optional
string
Exact event type filter, normalized to lowercase.
limit · optional
integer
Number of deliveries, 1-500. Default 100; values outside this range are rejected.

Name	Type	Description
subscriptionId	string	Filter by subscription id.
status	string	Exact status filter, normalized to lowercase; values are not separately validated.
eventType	string	Exact event type filter, normalized to lowercase.
limit	integer	Number of deliveries, 1-500. Default 100; values outside this range are rejected.

Errors

Status	Meaning
401	Invalid API key or missing auth.
403	Missing webhooks:read scope.
422	Query parameter outside its allowed type or limit bounds.

Example

bash

curl -X GET "https://app.autotouch.ai/api/webhook-subscriptions/deliveries?subscriptionId=67c88a24b4dd8f2d4999f912&limit=50" \
    -H "Authorization: Bearer stk_your_key_id.your_secret"

Response example

json

{
    "deliveries": [
      {
        "delivery_id": "dlv_b3a7459b7a09cf5ad255e862",
        "event_id": "evt_7a2d1d95f063e6d97c6f2697",
    "event_type": "lead.created",
        "event_type": "bulk_job.completed",
        "subscription_id": "67c88a24b4dd8f2d4999f912",
        "status": "succeeded",
        "attempt_count": 1,
        "last_status_code": 200,
        "created_at": "2026-03-03T11:29:00.000Z",
        "updated_at": "2026-03-03T11:29:01.000Z"
      }
    ],
    "count": 1
  }