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

# List webhook endpoints

> List the integration webhook endpoints of your team, with their events, workspace filters, status and the reason an endpoint was disabled, if any.

Returns every [integration webhook](https://docs.qwairy.co/developers/integration-webhooks/overview.md)
endpoint of the team. The signing secret is never returned by a read.

Integration webhooks require an active Business, Agency Business or Enterprise plan. See [Integration webhooks](https://docs.qwairy.co/developers/integration-webhooks/overview.md).

**Authorization** `string` *required*

Bearer token for your team.

## Response

**data** `array`

The endpoints, each with the fields below.

**Endpoint**

**id** `string`

Endpoint identifier

**url** `string`

Full public HTTPS URL that receives the events. Every key that can read the team's webhooks, read-only keys included, receives it, so a token in the URL is not a secret: verify `X-Qwairy-Signature`

**description** `string | null`

Free description, at most 200 characters

**events** `string[]`

[Event types](https://docs.qwairy.co/developers/integration-webhooks/events.md) the endpoint receives

**brandIds** `string[]`

Workspaces the endpoint is limited to. An empty array means every workspace of the team

**enabled** `boolean`

Whether events are delivered

**disabledReason** `string | null`

`MANUAL`, `FAILING` or `PLAN` when the endpoint is disabled, otherwise `null`

**failingSince** `string | null`

ISO 8601 time of the first failure in the current streak

**previousSecretExpiresAt** `string | null`

ISO 8601 time when the previous signing secret stops being used, after a rotation

**version** `integer`

Opaque concurrency value, sent as `If-Match` on update and delete

**createdAt** `string`

ISO 8601 creation time

**updatedAt** `string`

ISO 8601 last update time

## Synthetic request and response

```bash theme={null}
curl "https://www.qwairy.co/api/v1/webhooks" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN"
```

```json theme={null}
{
  "data": [
    {
      "id": "eeeeeeee-0000-4000-8000-000000000000",
      "url": "https://hooks.example.com/qwairy",
      "description": "Production receiver",
      "events": ["run.completed", "run.failed"],
      "brandIds": [],
      "enabled": true,
      "disabledReason": null,
      "failingSince": null,
      "previousSecretExpiresAt": null,
      "version": 0,
      "createdAt": "2026-10-12T09:00:00.000Z",
      "updatedAt": "2026-10-12T09:00:00.000Z"
    }
  ]
}
```

## Errors

| Status | Code | Cause |
| - | - | - |
| `401` | Flat body | Missing or invalid token |
| `403` | `INSUFFICIENT_PLAN` | Generic plan refusal: "This endpoint is not included in the team's plan." |

Read errors use the flat or nested shapes described in [Error codes](https://docs.qwairy.co/developers/errors.md). On `429`, honor `Retry-After`.


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