Send a test event

post

https://app.ekas.io/v1/webhook-endpoints/{id}/test

Fires a synthetic event of the given event_type at this endpoint with an example payload, signed like a real delivery. Returns the resulting delivery so you can inspect the HTTP status and response snippet.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

Body Params

event_type

string

enum

required

All webhook event types. GET /event-types returns this catalog with descriptions.

Headers

Idempotency-Key

string

length ≤ 255

Any unique string (e.g. a UUID). Retries with the same key within 24h return the original response with Idempotent-Replayed: true. Same key + different body → 409.

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200The delivery record for the synthetic event.

400Invalid request (malformed body, missing/invalid parameter).

401Missing or invalid API key.

403API key lacks a required scope (named in error.param) or test-only endpoint called with a live key.

404No such resource (or it belongs to another mode/subaccount).

409Invalid state transition, in-flight registration conflict, or idempotency key reuse with a different body.

429Rate limit exceeded; see Retry-After. RateLimit-* headers appear on every response, not only 429s.