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

# Get a webhook endpoint

> Read one integration webhook endpoint with its events, workspace filter, status, failure state and the expiry time of a previous signing secret.

Returns one endpoint and its `ETag`. Use the `ETag` as `If-Match` when you
[update](https://docs.qwairy.co/developers/endpoints/webhooks/update.md) or [delete](https://docs.qwairy.co/developers/endpoints/webhooks/delete.md) the endpoint.

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.

**webhookId** `string` *required*

Endpoint identifier.

## Response

Returns `200` with `ETag` and the 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 -i "https://www.qwairy.co/api/v1/webhooks/$WEBHOOK_ID" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN"
# ETag: "0"
```

```json theme={null}
{
  "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." |
| `404` | `RESOURCE_NOT_FOUND` | The endpoint is missing or belongs to another team |

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.