List webhook endpoints

List the webhook endpoints you can manage.

GET /api/v1/webhook_endpoints

cURL

curl "https://api.wordsmith.ai/api/v1/webhook_endpoints" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

{
  "items": [
    {
      "id": "0e7b3c5a-9d21-4f86-b4a0-6c8e2f1d7a39",
      "url": "https://your-app.com/webhooks/wordsmith",
      "description": "Matter management sync",
      "event_types": [
        "task.assigned",
        "task.status_changed",
        "review.completed"
      ],
      "audience": "user",
      "status": "enabled",
      "disabled_reason": null,
      "api_version": "2026-11-01",
      "last_delivery": {
        "at": "2026-11-09T10:12:04Z",
        "delivered": true,
        "response_status": 200,
        "error_code": null
      },
      "created_at": "2026-11-09T10:00:00Z",
      "updated_at": "2026-11-09T10:00:00Z"
    }
  ],
  "cursor": null
}

Returns your own endpoints, oldest first. With webhooks:admin and the permission to manage organisation webhooks, your organisation’s endpoints are listed too. See Webhook endpoints.

​

Authentication

Requires an API key, or an OAuth token with webhooks:read.

​

Query parameters

cursor · string

The cursor from the previous page.

limit · integer · default: "50"

Endpoints per page, from 1 to 100.

​

Response

Returns a page of endpoints. A cursor of null means there are no more.

cURL

curl "https://api.wordsmith.ai/api/v1/webhook_endpoints" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

{
  "items": [
    {
      "id": "0e7b3c5a-9d21-4f86-b4a0-6c8e2f1d7a39",
      "url": "https://your-app.com/webhooks/wordsmith",
      "description": "Matter management sync",
      "event_types": [
        "task.assigned",
        "task.status_changed",
        "review.completed"
      ],
      "audience": "user",
      "status": "enabled",
      "disabled_reason": null,
      "api_version": "2026-11-01",
      "last_delivery": {
        "at": "2026-11-09T10:12:04Z",
        "delivered": true,
        "response_status": 200,
        "error_code": null
      },
      "created_at": "2026-11-09T10:00:00Z",
      "updated_at": "2026-11-09T10:00:00Z"
    }
  ],
  "cursor": null
}

​

Errors

Status	error_code	When
400	bad_request	A limit outside 1 to 100, or a cursor this API did not return.
404	resource_not_found	Webhooks are not on for your organisation.