Ereignisse · Karten
card.created
Karte erstellt
Eine Karte wurde erstellt: durch den Upload einer Datei oder eines Textes, einen Archiveintrag, ein Dokument aus einer Quelle, einen veröffentlichten Entwurf oder eine gespeicherte Antwort. Anschließend läuft die Indexierung, die mit card.indexed oder card.index_failed endet.
- Objekttyp
- card
- Zugestellt an
- Endpunkte, die das Objekt sehen können: nach Rolle, Datenprofil und Sammlungen
Payload
idstringerforderlichEreignis-ID (
evt_…), auch als Headerwebhook-idgesendet. Verwenden Sie sie, um doppelte Zustellungen zu verwerfen.typestringerforderlichZulässige Werte:
card.createdcreated_atstring (date-time)erforderlichWann die Änderung stattgefunden hat (UTC).
org_idintegererforderlichapi_versionstringerforderlichVertragsversion des Schemas von
data.sequenceintegerLaufende Nummer der Zustellung innerhalb des Endpunkts (fehlt bei einem Testereignis).
payloadstringerforderlichthinbedeutet keindata: Lesen Sie das Objekt über die API.Zulässige Werte:
fullthindataobjectFelder
actor_idinteger | nullerforderlichDer Benutzer, der die Aktion ausgeführt hat;
nullbei einem API-Schlüssel der Organisation oder der Plattform selbst.job_idinteger | nullDer Indexierungs- oder Exportjob.
testbooleanerforderlichEin Testereignis, gesendet durch
POST /v1/webhooks/{webhook_id}/test.
Beispielzustellung
{
"id": "evt_0123456789abcdef0123456789abcdef",
"type": "card.created",
"created_at": "2026-10-24T10:00:03Z",
"org_id": 1,
"api_version": "1.62.0",
"sequence": 1042,
"object": {
"type": "card",
"id": "c_9f2e41"
},
"payload": "full",
"data": {
"card": {
"id": "c_9f2e41",
"title": "Refund policy",
"collection": "support",
"collection_id": 3,
"version": 4,
"kind": "text",
"status": "ready",
"verification_state": "trusted",
"owner_id": 7,
"tags": [
"billing"
],
"external_id": null,
"metadata": {}
},
"actor_id": 7,
"job_id": 4410
},
"test": false
}Ereignisse empfangen
Jede Zustellung ist eine POST-Anfrage mit diesem JSON-Body an Ihren Endpunkt. Prüfen Sie den Header webhook-signature (Standard Webhooks), bevor Sie dem Body vertrauen, antworten Sie innerhalb weniger Sekunden mit einem Status 2xx und erledigen Sie die Arbeit danach. Zustellungen an einen Endpunkt behalten die Reihenfolge der Ereignisse bei; eine fehlgeschlagene Zustellung wird mit wachsenden Pausen wiederholt.
Neue Ereignistypen und neue Felder können jederzeit hinzukommen: Überspringen Sie Typen und Felder, die Sie nicht kennen.