Get a webhook endpoint
curl --request GET \
--url https://www.qwairy.co/api/v1/webhooks/{webhookId} \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/webhooks/{webhookId}"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://www.qwairy.co/api/v1/webhooks/{webhookId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"url": "<string>",
"description": {},
"events": [
"<string>"
],
"brandIds": [
"<string>"
],
"enabled": true,
"disabledReason": {},
"failingSince": {},
"previousSecretExpiresAt": {},
"version": 123,
"createdAt": "<string>",
"updatedAt": "<string>"
}Webhook endpoints
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.
GET
https://www.qwairy.co
/
api
/
v1
/
webhooks
/
{webhookId}
Get a webhook endpoint
curl --request GET \
--url https://www.qwairy.co/api/v1/webhooks/{webhookId} \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/webhooks/{webhookId}"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://www.qwairy.co/api/v1/webhooks/{webhookId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"url": "<string>",
"description": {},
"events": [
"<string>"
],
"brandIds": [
"<string>"
],
"enabled": true,
"disabledReason": {},
"failingSince": {},
"previousSecretExpiresAt": {},
"version": 123,
"createdAt": "<string>",
"updatedAt": "<string>"
}Returns one endpoint and its
Read errors use the flat or nested shapes described in Error codes. On
ETag. Use the ETag as If-Match when you
update or delete the endpoint.
Integration webhooks require an active Business, Agency Business or Enterprise plan. See Integration webhooks.
Response
Returns200 with ETag and the endpoint.
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-SignatureEvent types the endpoint receives
Synthetic request and response
curl -i "https://www.qwairy.co/api/v1/webhooks/$WEBHOOK_ID" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN"
# ETag: "0"
{
"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 |
429, honor Retry-After.
