Get Webhooks

get/v1/subscriptions/webhooks

Returns every webhook subscription registered for the authenticated workspace, newest first. Read only, no side effects. Results are cursor paginated.

Requires a bearer token: Authorization: Bearer <token>.

Query parameters

Name	Type	Required	Description
cursor	string	No	Opaque pagination cursor returned in links.next of a previous page. Omit to fetch the first page.e.g. eyJwayI6MTQyfQ
limit	integer	No	Maximum number of subscriptions to return per page.e.g. 25

Request

cURL

curl -X GET https://api.wellapp.ai/v1/subscriptions/webhooks \
  -H "Authorization: Bearer $WELL_API_TOKEN"

Responses

200 — A page of webhook subscriptions.

{
  "data": [
    {
      "type": "webhook",
      "id": "c47e2f81-9b3a-4d6e-8f10-2a5b7c9d1e3f",
      "attributes": {
        "event": "document.processed",
        "target_url": "https://foldspace.ai/webhooks/well",
        "headers": {
          "X-Foldspace-Token": "fold_7c1e9a"
        },
        "active": true,
        "created_at": "2026-06-07T14:22:05.000Z",
        "updated_at": null
      }
    }
  ],
  "meta": {
    "total": 1,
    "count": 1
  },
  "links": {
    "next": null
  }
}

400 — Invalid pagination parameters.

{
  "code": "BAD_REQUEST",
  "status": 400,
  "title": "Bad Request",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

401 — Missing or invalid bearer token.

{
  "code": "UNAUTHORIZED",
  "status": 401,
  "title": "Unauthorized",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}