Send a test event
curl --request POST \
--url https://www.qwairy.co/api/v1/webhooks/{webhookId}/test \
--header 'Authorization: <authorization>' \
--header 'Idempotency-Key: <idempotency-key>'import requests
url = "https://www.qwairy.co/api/v1/webhooks/{webhookId}/test"
headers = {
"Authorization": "<authorization>",
"Idempotency-Key": "<idempotency-key>"
}
response = requests.post(url, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<authorization>', 'Idempotency-Key': '<idempotency-key>'}
};
fetch('https://www.qwairy.co/api/v1/webhooks/{webhookId}/test', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"eventId": "<string>",
"event": "<string>",
"status": "<string>",
"attempts": 123,
"nextAttemptAt": {},
"lastAttemptAt": {},
"lastStatusCode": {},
"lastError": {},
"deliveredAt": {},
"createdAt": "<string>"
}Webhook endpoints
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.
POST
https://www.qwairy.co
/
api
/
v1
/
webhooks
/
{webhookId}
/
test
Send a test event
curl --request POST \
--url https://www.qwairy.co/api/v1/webhooks/{webhookId}/test \
--header 'Authorization: <authorization>' \
--header 'Idempotency-Key: <idempotency-key>'import requests
url = "https://www.qwairy.co/api/v1/webhooks/{webhookId}/test"
headers = {
"Authorization": "<authorization>",
"Idempotency-Key": "<idempotency-key>"
}
response = requests.post(url, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<authorization>', 'Idempotency-Key': '<idempotency-key>'}
};
fetch('https://www.qwairy.co/api/v1/webhooks/{webhookId}/test', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"eventId": "<string>",
"event": "<string>",
"status": "<string>",
"attempts": 123,
"nextAttemptAt": {},
"lastAttemptAt": {},
"lastStatusCode": {},
"lastError": {},
"deliveredAt": {},
"createdAt": "<string>"
}Queues a
See Error codes for authentication, plan, idempotency and server errors. A token without write access returns
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 passes. Read the
outcome with List deliveries.
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 and Writing data.
Unique key for this operation, at most 255 characters. Completed responses replay for 24 hours.
Response
Returns202 with the queued delivery.
Synthetic request and response
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"
{
"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 |
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.
