Passer au contenu principal
POST
Créer un point de terminaison de webhook
Enregistre un nouveau point de terminaison de webhook pour le locataire authentifié. Le point de terminaison reçoit des requêtes HTTP POST lorsque des événements correspondants se produisent. Le secret du point de terminaison est renvoyé une seule fois dans la réponse — stockez-le en toute sécurité.
Le nombre de points de terminaison de webhook que vous pouvez créer dépend de votre plan de facturation. Si vous dépassez la limite de votre plan, l’API renvoie 402 Payment Required.

Réponses

Le champ secret n’est renvoyé que dans la réponse de création. Stockez-le en toute sécurité — vous ne pourrez pas le récupérer plus tard. Si vous le perdez, faites pivoter le secret pour en générer un nouveau.

Autorisations

X-API-Key
string
header
requis

Clé API pour l'authentification machine-à-machine

Corps

application/json
name
string
requis

Nom de point de terminaison lisible par l'homme

url
string
requis

URL HTTPS pour les livraisons de webhook

event_filters
string[]
requis

Types d'événements ou modèles génériques

Réponse

Point de terminaison créé

id
string
name
string
url
string
status
string
secret
string
event_filters
string[]
created_at
string