Créer un endpoint de webhook
curl --request POST \
--url https://www.qwairy.co/api/v1/webhooks \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"url": "<string>",
"events": [
"<string>"
]
}
'import requests
url = "https://www.qwairy.co/api/v1/webhooks"
payload = {
"url": "<string>",
"events": ["<string>"]
}
headers = {
"Authorization": "<authorization>",
"Idempotency-Key": "<idempotency-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: '<authorization>',
'Idempotency-Key': '<idempotency-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({url: '<string>', events: ['<string>']})
};
fetch('https://www.qwairy.co/api/v1/webhooks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"secret": "<string>"
}Endpoints de webhook
Créer un endpoint de webhook
Enregistrez un endpoint HTTPS pour les événements de webhook d’intégration. Le secret de signature n’est renvoyé qu’une fois. Maximum de 10 endpoints.
POST
https://www.qwairy.co
/
api
/
v1
/
webhooks
Créer un endpoint de webhook
curl --request POST \
--url https://www.qwairy.co/api/v1/webhooks \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"url": "<string>",
"events": [
"<string>"
]
}
'import requests
url = "https://www.qwairy.co/api/v1/webhooks"
payload = {
"url": "<string>",
"events": ["<string>"]
}
headers = {
"Authorization": "<authorization>",
"Idempotency-Key": "<idempotency-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: '<authorization>',
'Idempotency-Key': '<idempotency-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({url: '<string>', events: ['<string>']})
};
fetch('https://www.qwairy.co/api/v1/webhooks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"secret": "<string>"
}Crée un endpoint pour l’équipe. Le secret de signature n’est renvoyé qu’une fois, dans cette réponse uniquement. Conservez-le pour vérifier les signatures. Une équipe peut avoir 10 endpoints au maximum.
Les webhooks d’intégration nécessitent une offre Business, Agency Business ou Enterprise active. Modifier un endpoint exige aussi un jeton d’API dont l’accès en écriture a été activé par un Propriétaire ou un Manager. Consultez Webhooks d’intégration et Écrire des données.
Les autres champs sont décrits dans Lister les endpoints de webhook.
Consultez Codes d’erreur pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Un jeton sans accès en écriture renvoie
Clé unique pour cette opération, 255 caractères au maximum. Les réponses terminées sont rejouées pendant 24 heures.
Au moins un type d’événement :
run.completed, run.failed, run.cancelled, pitch_audit.completed, pitch_audit.failed, site_audit.completed, prompt_suggestions.ready, prompt_suggestions.failed ou webhook.test.Limite l’endpoint à ces workspaces, 100 au maximum. Omettez-le ou envoyez un tableau vide pour recevoir les événements de tous les workspaces de l’équipe.
Réponse
Renvoie201 avec Location, ETag et l’endpoint, plus le secret.
Secret de signature. Affiché une seule fois ; il ne peut plus être relu. Renouvelez-le avec Renouveler le secret de signature si vous le perdez.
Requête et réponse synthétiques
curl -X POST "https://www.qwairy.co/api/v1/webhooks" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN" \
-H "Idempotency-Key: webhook-endpoint-001" \
-H "Content-Type: application/json" \
-d '{"url":"https://hooks.example.com/qwairy","description":"Production receiver","events":["run.completed","run.failed"]}'
{
"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",
"secret": "synthetic-signing-secret"
}
Erreurs
| Statut | Code | Cause |
|---|---|---|
400 | INVALID_REQUEST | URL invalide, événement inconnu ou valeur hors plage |
409 | CONFLICT | La requête entre en conflit avec les endpoints actuels, par exemple la limite de 10 endpoints |
409 | IDEMPOTENCY_CONFLICT | La clé a été réutilisée avec un corps différent |
403 API_KEY_READ_ONLY. Sur 429, respectez Retry-After. Si le limiteur d’écriture est indisponible ou si les écritures sont suspendues, la requête renvoie 503 SERVICE_UNAVAILABLE et rien ne change.
