List webhook subscriptions

Returns a paginated list of webhook subscriptions for the site. Optionally filter by event type (event) or by the external system that owns the subscription (managedBy, e.g. 'zapier').

Each item includes the webhook id, name, delivery URL, event list, active status, secret prefix (first 10 chars — the full secret is only returned at creation time), and managedBy marker.

Use this endpoint to discover existing subscriptions (e.g. Zapier dedupe on Zap enable) or to audit which integrations are wired up.

GET /api/v1/webhooks

Bearer token

curl 'https://api.sotion.so/api/v1/webhooks?limit=50&after=123e4567-e89b-42d3-a456-426614174000&event=member.created&managedBy=example' \
  --request GET \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "data": [
    {
      "id": "123e4567-e89b-42d3-a456-426614174000",
      "name": "example",
      "url": "https://example.com",
      "events": [
        "member.created"
      ],
      "active": true,
      "secretPrefix": "example",
      "managedBy": "example",
      "createdAt": "2026-01-01T12:00:00Z",
      "updatedAt": "2026-01-01T12:00:00Z"
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "123e4567-e89b-42d3-a456-426614174000"
  }
}

Paginated list of webhook subscriptions.

Query parameters

· 4

limit integer · min: 1· max: 100· default: 50

Number of items to return per page (1-100). Default: 50.

after string · uuid

Cursor for pagination. Pass the nextCursor value from a previous response to get the next page of results.

event string · enum

Filter to subscriptions that include this event type.

values

member.created
member.updated
member.auth
member.deleted
access-group.created
access-group.updated

managedBy string · max length: 50

Filter to subscriptions created by a specific external system. Common values: 'zapier'. Omit for all.

Query parameters

Responses