Skip to main content
POST
S'abonner à des événements

Authorizations

Authorization
string
header
required

Une clé = un workspace ; la clé détermine le workspace, aucun workspace_id ne circule jamais dans les requêtes. Le schéma Bearer est insensible à la casse. Une clé révoquée est refusée immédiatement.

Body

application/json
url
string<uri>
required

HTTPS obligatoire ; aucune adresse privée ou locale ; aucun identifiant dans l'URL.

events
enum<string>[]
required
Available options:
run.completed,
lead.created,
automation.status_changed

Callbacks

POST
{$request.body#/url}delivery

Body

application/json

Corps envoyé à l'URL abonnée. type (valeur de WebhookEvent) détermine la forme de data : un Lead pour lead.created, un Run pour run.completed, une Automation pour automation.status_changed.

id
string
required

Identifiant opaque préfixé evt_, unique par événement — clé de déduplication du récepteur.

created_at
string<date-time>
required
type
enum<string>
required
Available options:
lead.created
data
object
required

Response

Livraison acquittée (corps ignoré)

Response

Abonnement créé — le secret n'est retourné qu'une seule fois

id
string
required

Identifiant opaque préfixé whk_.

url
string<uri>
required
events
enum<string>[]
required
Available options:
run.completed,
lead.created,
automation.status_changed
created_at
string<date-time>
required
disabled_at
string<date-time> | null
required

Posé quand l'abonnement a été désactivé après des échecs prolongés.

secret
string
required

Affiché une seule fois, sert à vérifier les signatures