List webhook subscriptions

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

Every response is limited to subscriptions owned by the authenticated organization. The signing secret is omitted; only its last four characters are returned.

Query parameters

includeDisabled · optional
boolean
Default true. Set false to return enabled subscriptions only.
limit · optional
integer
Number of subscriptions, 1-500. Default 100; values outside this range are rejected.

Name	Type	Description
includeDisabled	boolean	Default true. Set false to return enabled subscriptions only.
limit	integer	Number of subscriptions, 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?includeDisabled=true&limit=100" \
    -H "Authorization: Bearer stk_your_key_id.your_secret"

Response example

json

{
    "subscriptions": [
      {
        "id": "67c88a24b4dd8f2d4999f912",
        "organization_id": "67b03b8f0af6e6aaf0ec4f40",
        "url": "https://example.com/webhooks/smart-table",
        "enabled": true,
        "status": "active",
        "events": ["bulk_job.*", "lead.*"],
        "filters": {},
        "retry_policy": {
          "max_attempts": 8,
          "base_delay_seconds": 10,
          "max_delay_seconds": 900,
          "timeout_seconds": 10
        },
        "signing_secret_last4": "A7m2",
        "created_at": "2026-03-03T11:24:00.000Z",
        "updated_at": "2026-03-03T11:24:00.000Z"
      }
    ],
    "count": 1
  }