Gérer les abonnements
Créer, lister et supprimer les destinations de vos événements.
POST /webhooks
Crée un abonnement. url est obligatoire et doit utiliser HTTPS avec un hôte public. events est un tableau non vide contenant uniquement les événements pris en charge. source est facultatif : zapier, make ou custom (par défaut).
[
"reservation.created",
"reservation.modified",
"reservation.cancelled",
"customer.created",
"call.completed",
"callback.requested",
"quote.requested",
"vehicle.created",
"repair.status_changed"
]
{
"url": "https://hooks.zapier.com/hooks/catch/12345/abcde/",
"events": [
"reservation.created",
"reservation.cancelled"
],
"source": "zapier"
}
{
"id": 7,
"url": "https://hooks.zapier.com/hooks/catch/12345/abcde/",
"events": [
"reservation.created",
"reservation.cancelled"
],
"source": "zapier",
"secret": "b6f1...e4"
}
Erreurs : 400 pour une URL absente/non HTTPS ou des événements invalides ; 400 forbidden-target pour une destination interdite ; 403 not-entitled pour une offre incompatible ; 401 pour une clé absente ou invalide.
GET /webhooks
Liste jusqu’aux 100 abonnements les plus récents de votre entreprise, du plus récent au plus ancien. Le secret n’est jamais inclus.
{
"docs": [
{
"id": 7,
"url": "https://hooks.zapier.com/hooks/catch/12345/abcde/",
"events": [
"reservation.created",
"reservation.cancelled"
],
"source": "zapier",
"status": "active",
"consecutiveFailures": 0,
"lastDeliveredAt": "2026-07-04T10:12:03.000Z",
"lastError": null,
"createdAt": "2026-07-01T09:00:00.000Z"
}
]
}
status vaut active, failing ou disabled.
DELETE /webhooks/:id
curl -X DELETE 'https://app.kawlya.com/api/integrations/v1/webhooks/7' \
-H "Authorization: Bearer $KAWLYA_API_KEY"
Succès : 204 sans contenu. Un identifiant absent ou appartenant à une autre entreprise renvoie 404 avec l’erreur not-found.