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

# Send a test event

> Queue a webhook.test event for one integration webhook endpoint, even when it is disabled, to check your receiver and signature verification.

Queues a `webhook.test` event for this endpoint only, even when the endpoint is
disabled. Use it to check that your receiver is reachable and that your
[signature verification](https://docs.qwairy.co/developers/integration-webhooks/verify-signatures.md) passes. Read the
outcome with [List deliveries](https://docs.qwairy.co/developers/endpoints/webhooks/deliveries.md).

Integration webhooks require an active Business, Agency Business or Enterprise plan. Changing an endpoint also requires an API token with write access enabled by an Owner or Manager. See [Integration webhooks](https://docs.qwairy.co/developers/integration-webhooks/overview.md) and [Writing data](https://docs.qwairy.co/developers/writing-data.md).

**Authorization** `string` *required*

Bearer token for your team.

**Idempotency-Key** `string` *required*

Unique key for this operation, at most 255 characters. Completed responses replay for 24 hours.

**webhookId** `string` *required*

Endpoint identifier.

## Response

Returns `202` with the queued delivery.

**id** `string`

Delivery identifier, stable across attempts. It is also sent in the `X-Qwairy-Delivery` header

**eventId** `string`

Identifier of the event, the `id` of the payload. Redeliveries keep it

**event** `string`

[Event type](https://docs.qwairy.co/developers/integration-webhooks/events.md)

**status** `string`

`PENDING`, `DELIVERING`, `SUCCEEDED`, `RETRYING`, `EXHAUSTED` or `CANCELLED`

**attempts** `integer`

Attempts made so far, from 0 to 8

**nextAttemptAt** `string | null`

ISO 8601 time of the next attempt

**lastAttemptAt** `string | null`

ISO 8601 time of the latest attempt

**lastStatusCode** `integer | null`

HTTP status returned by your endpoint on the latest attempt

**lastError** `string | null`

`TIMEOUT`, `CONNECTION`, `HTTP_STATUS` or `BLOCKED_TARGET` for the latest failed attempt

**deliveredAt** `string | null`

ISO 8601 time of the successful attempt

**createdAt** `string`

ISO 8601 creation time

## Synthetic request and response

```bash theme={null}
curl -X POST "https://www.qwairy.co/api/v1/webhooks/$WEBHOOK_ID/test" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H "Idempotency-Key: webhook-test-001"
```

```json theme={null}
{
  "id": "ffffffff-0000-4000-8000-000000000000",
  "eventId": "evt_3f2a9c1e-5b7d-4e08-8a41-0c9d6e2b7f10",
  "event": "webhook.test",
  "status": "PENDING",
  "attempts": 0,
  "nextAttemptAt": "2026-10-12T09:00:00.000Z",
  "lastAttemptAt": null,
  "lastStatusCode": null,
  "lastError": null,
  "deliveredAt": null,
  "createdAt": "2026-10-12T09:00:00.000Z"
}
```

## Errors

| Status | Code | Cause |
| - | - | - |
| `404` | `RESOURCE_NOT_FOUND` | The endpoint is missing or belongs to another team |
| `409` | `IDEMPOTENCY_CONFLICT` | The key was reused with a different request |

See [Error codes](https://docs.qwairy.co/developers/errors.md) for authentication, plan, idempotency and server errors. A token without write access returns `403 API_KEY_READ_ONLY`. On `429`, honor `Retry-After`. If the write limiter is unavailable or writes are suspended, the request returns `503 SERVICE_UNAVAILABLE` and nothing changes.


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