Események · Személyek és hozzáférés
api_key.created
API-kulcs létrehozva
API-kulcs jött létre: szervezeti kulcs, személyes kulcs vagy forráskulcs. A kulcs értékét az esemény soha nem tartalmazza.
- Objektumtípus
- api_key
- Címzett webhookok
- Az admin szerepkörű webhookok
Adattartalom
idstringkötelezőAz esemény azonosítója (
evt_…), amelywebhook-idfejlécként is érkezik. Ezzel szűrheted ki az ismétlődő kézbesítéseket.typestringkötelezőMegengedett értékek:
api_key.createdcreated_atstring (date-time)kötelezőMikor történt a változás (UTC).
org_idintegerkötelezőapi_versionstringkötelezőA
dataséma szerződésverziója.sequenceintegerA kézbesítés sorszáma a webhookon belül (tesztesemény esetén hiányzik).
payloadstringkötelezőA
thinazt jelenti, hogy nincsdata: az objektumot az API-n keresztül olvasd ki.Megengedett értékek:
fullthindataobjectMezők
actor_idinteger | nullkötelezőA műveletet végző felhasználó;
null, ha a műveletet a szervezet API-kulcsa vagy maga a platform végezte.
testbooleankötelezőA
POST /v1/webhooks/{webhook_id}/testáltal küldött tesztesemény.
Példa kézbesítésre
{
"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
}Események fogadása
Minden kézbesítés egy ilyen JSON-törzsű POST kérés a webhookod URL-jére. Mielőtt megbíznál a törzsben, ellenőrizd a webhook-signature fejlécet (Standard Webhooks), néhány másodpercen belül válaszolj 2xx állapotkóddal, és a feldolgozást csak ezután végezd el. Az egy webhooknak szóló kézbesítések megtartják az események sorrendjét; a sikertelen kézbesítést a rendszer egyre hosszabb szünetekkel újrapróbálja.
Új eseménytípusok és új mezők bármikor megjelenhetnek: hagyd figyelmen kívül azokat a típusokat és mezőket, amelyeket nem ismersz.
Ugyanezek az események 30 napig az eseménycsatornában is megtalálhatók →