Vous pourriez avoir besoin d’être averti chaque fois qu’un événement intéressant se produit dans votre espace de travail. C’est à cela que servent les webhooks.
Par défaut, si vous êtes membre d’un espace de travail en tant que Propriétaire, Administrateur ou intégrateur, vous pouvez créer un Webhook endpoint depuis l’Espace développeur de l’application Web Universign.
Toutefois, si vous êtes Master Admin d’une Master Console, vous pouvez créer des Webhook endpoint pour suivre des événements déclenchés par un espace de travail lié à votre Master Account.
Notez que cette opération n’est autorisée que pour les catégories de clients Entreprise et Intégrateur.
Pour créer un webhook endpoint pour un espace de travail lié à votre Master Account, envoyez une requête à POST /v1/webhook-endpoints et transmettez les arguments requis.
Vous devez définir la clé API de la Master Console pour authentifier votre requête, comme dans l’exemple ci-dessous :
https://api.universign.com/v1/webhook-endpoints \
-H Authorization: Bearer apikey_my_master_account_apikey
-d workspace_id=wsp_5X \
-d name=test_webhook_endpoint \
-d url=https://www.mywebhook.com \
-d event_types=["transaction.lifecycle.created", "action.opened"]
workspace_id: l’identifiant de l’espace de travail lié au Master Account.name: le nom du webhook endpoint.url: l’URL du webhook (seules les URL sécurisées sont acceptées).event_types: les types d’événements que vous souhaitez suivre, séparés par une virgule. Pour la liste de tous nos événements webhookables, consultez Événements.
The API returns a webhook-endpoint object as follows:
{
"object": "webhook-endpoint",
"id": "whe_5X",
"created_at": "2026-04-14T07:04:37.458Z",
"name": "test_webhook_endpoint",
"url": "https://www.mywebhook.com",
"tenant_id": "wsp_5X",
"event_types": ["transaction.lifecycle.created", "action.opened"]
}
```
