Send a test event
Sends one signed sample event (marked test: true) to the endpoint now and returns the delivery with your endpoint’s response. Pick the sample with event_type.
Scopes: webhook:write
Authorizations
An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.
Headers
A unique key (a UUID works) for this request. Retrying with the same key returns the first answer instead of running twice.
255The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.
2026-11-07 "2026-11-07"
Path Parameters
Body
Send this event type's sample payload. Omit for a plain webhook.test.
80Response
Successful Response
The delivery id (whd_… for tests).
The event's id; the same across retries, so receivers can dedupe.
The endpoint it goes to.
Where it stands.
pending, retrying, delivered, dead, canceled Tries so far.
True for a test event.
When it was queued.
The event type.
The endpoint URL at the time.
The exact JSON body sent (signatures are in headers, not here).
Every try, oldest first.
The latest try.
When your endpoint accepted it.
When the next retry is due.
The latest failure, readable.
Your endpoint's latest HTTP status.
The latest try's duration.
The delivery this re-sends, if any.
The payload version it was sent as.
When the event happened.
The endpoint's label.