Créer un endpoint webhook

POST 
/api/v1/workspaces/:workspace_id/webhook_endpoints

Crée un nouvel endpoint webhook dans l'espace de travail indiqué. La réponse inclut le signing_secret exactement une fois - il n'est plus jamais retourné, sauf via regenerate_secret.

Request

Responses

201

L'endpoint webhook a été créé. Son signing_secret est inclus dans cette réponse - enregistrez-le maintenant, car il n'est montré qu'une seule fois et n'est plus jamais retourné, sauf via regenerate_secret.

401

La requête ne comporte pas de jeton d'accès (bearer token), ou celui-ci est invalide ou expiré.

403

Le jeton de l'application OAuth est valide, mais l'application ne dispose d'aucune autorisation d'accès pour l'espace de travail demandé, ou un tel espace de travail n'existe pas.

422

Le payload webhook_endpoint a échoué la validation - url doit utiliser https et event_type doit être l'un des types d'événement pris en charge. Deux règles sont propres à l'événement plutôt que globales. includes ne peut nommer que des valeurs autorisées par le type d'événement choisi, et seul invoice.created en autorise - invoice.lifecycle_event.created comme bank_account.updated livrent un payload qu'aucun include ne restreint, aucun des deux n'en accepte donc. category_id ne peut être renseigné que sur un type d'événement que la répartition sait router par catégorie, ce qui exclut bank_account.updated et lui seul - un abonnement qui lui lierait une catégorie ne recevrait jamais rien. Le corps de la réponse liste chaque attribut invalide et son motif sous errors.