Événements · Personnes et accès
api_key.created
Clé API créée
Une clé API a été créée : clé de l’organisation, clé personnelle ou clé de source. La valeur de la clé n’est jamais envoyée.
- Type d’objet
- api_key
- Livré à
- Webhooks dotés du rôle admin
Charge utile
idstringobligatoireID de l’événement (
evt_…), également envoyé dans l’en-têtewebhook-id. Utilisez-le pour écarter les livraisons en double.typestringobligatoireValeurs autorisées:
api_key.createdcreated_atstring (date-time)obligatoireDate de la modification (UTC).
org_idintegerobligatoireapi_versionstringobligatoireVersion du contrat du schéma de
data.sequenceintegerNuméro de séquence de la livraison au sein du webhook (absent pour un événement de test).
payloadstringobligatoirethinsignifie sansdata: lisez l’objet via l’API.Valeurs autorisées:
fullthindataobjectChamps
actor_idinteger | nullobligatoireUtilisateur qui a effectué l’action ;
nullpour une clé API de l’organisation ou la plateforme elle-même.
testbooleanobligatoireÉvénement de test envoyé par
POST /v1/webhooks/{webhook_id}/test.
Exemple de livraison
{
"id": "evt_0123456789abcdef0123456789abcdef",
"type": "api_key.created",
"created_at": "2026-10-24T10:00:03Z",
"org_id": 1,
"api_version": "1.62.0",
"sequence": 1042,
"object": {
"type": "api_key",
"id": "14"
},
"payload": "full",
"data": {
"api_key": {
"id": 14,
"name": "CRM sync",
"prefix": "kb_3f9a",
"kind": "org",
"role": "editor",
"scopes": [
"cards:read",
"cards:write"
],
"expires_at": "2026-10-31T00:00:00Z"
},
"actor_id": 7
},
"test": false
}Recevoir les événements
Chaque livraison est une requête POST envoyée à votre webhook avec ce corps JSON. Vérifiez l’en-tête webhook-signature (Standard Webhooks) avant de vous fier au corps, répondez par un statut 2xx en quelques secondes et faites le traitement ensuite. Les livraisons vers un même webhook respectent l’ordre des événements ; une livraison en échec est relancée avec des pauses de plus en plus longues.
De nouveaux types d’événements et de nouveaux champs peuvent apparaître à tout moment : ignorez les types et les champs que vous ne connaissez pas.
Les mêmes événements restent 30 jours dans le flux d’événements →