> ## Documentation Index
> Fetch the complete documentation index at: https://wordsmithai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List webhook endpoints

> List the webhook endpoints you can manage.

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](https://wordsmithai.mintlify.site/webhook-endpoints.md).

## 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.

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.wordsmith.ai/api/v1/webhook_endpoints" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"
```

```json Response theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.