Get webhook subscription

Get one webhook subscription by ID.

GET/api/webhook-subscriptions/{subscription_id}

Scope webhooks:readUpdated September 27, 2026

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

Subscription IDs are looked up within the authenticated organization. The stored signing secret is never returned; only signing_secret_last4 is exposed.

Path parameters

subscription_idrequired
string
Subscription ID.

Name	Type	Description
subscription_idrequired	string	Subscription ID.

Errors

Status	Meaning
401	Invalid API key or missing auth.
403	Missing webhooks:read scope.
404	Subscription not found.

Example

bash

curl -X GET "https://app.autotouch.ai/api/webhook-subscriptions/67c88a24b4dd8f2d4999f912" \
    -H "Authorization: Bearer stk_your_key_id.your_secret"

Response example

json

{
    "success": true,
    "subscription": {
      "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"
    }
  }