Händelser · Webhooktjänstens händelser

webhook.ping

Testhändelse

Testhändelse som skickas av POST /v1/webhooks/{webhook_id}/test. Det går inte att prenumerera på den, och den skrivs inte till händelseflödet.

Objekttyp: webhook
Levereras till: Webhookar med rollen admin

Nyttolast

Objekt: EventWebhookPing

idstringobligatorisk
Händelsens id (evt_…), skickas också som huvudet webhook-id. Använd det för att kasta dubblettleveranser.
typestringobligatorisk
Tillåtna värden: webhook.ping
created_atstring (date-time)obligatorisk
När ändringen inträffade (UTC).
org_idintegerobligatorisk
api_versionstringobligatorisk
Kontraktsversion för schemat data.
sequenceinteger
Leveransens löpnummer inom webhooken (saknas för en testhändelse).
objectWebhookEventObjectobligatorisk
payloadstringobligatorisk
thin betyder ingen data: läs objektet via API:et.
Tillåtna värden: fullthin
dataobject
Fält
- endpoint_idintegerobligatorisk
- messagestringobligatorisk
- requested_byinteger | null
testbooleanobligatorisk
En testhändelse som skickas av POST /v1/webhooks/{webhook_id}/test.

Exempel på leverans

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "webhook.ping",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "object": {
    "type": "webhook",
    "id": "4"
  },
  "payload": "full",
  "data": {
    "endpoint_id": 4,
    "message": "Test event from the knowledge platform",
    "requested_by": 7
  },
  "test": true
}

Ta emot händelser

Varje leverans är ett POST-anrop med den här JSON-brödtexten till din mottagare. Verifiera huvudet webhook-signature (Standard Webhooks) innan du litar på brödtexten, svara med en 2xx-status inom några sekunder och gör arbetet efteråt. Leveranserna till en och samma webhook kommer i samma ordning som händelserna; en misslyckad leverans görs om med allt längre pauser.

Nya händelsetyper och nya fält kan tillkomma när som helst: hoppa över de typer och fält som du inte känner till.

Samma händelser finns i händelseflödet i 30 dagar →