Events

An event is one webhook a source received. Events are kept for 30 days.

The event object

{
  "id": "01m3my2b42vahrbx8zt4fw84wc",
  "sourceId": "01m3m4v8kq0c6f3qg2x7w9d1ne",
  "receivedAt": "2026-10-01T09:12:44Z",
  "method": "POST",
  "path": "/",
  "status": "routed",
  "bodySize": 96,
  "deliveries": { "delivered": 1, "failed": 0, "waiting": 0 }
}

idstring

The event’s ID. Every delivery of it carries this ID in webhook-id.

sourceIdstring

The source that received it.

receivedAtstring

When it was received.

methodstring

The method it was sent with.

pathstring

The part of the address after the source’s address, / when there was none.

statusstring

routed when at least one connection took it, or filtered when none did.

bodySizeinteger

The body’s size in bytes.

deliveriesobject

How many of its deliveries are delivered, failed, and waiting.

List events

Returns the project’s events, newest first, a page at a time. See Paging.

sourcequery

Only the events of this source.

statusquery

routed or filtered.

Read an event

Returns the event with everything that was received, and every delivery it made:

{
  "id": "01m3my2b42vahrbx8zt4fw84wc",
  "sourceId": "01m3m4v8kq0c6f3qg2x7w9d1ne",
  "receivedAt": "2026-10-01T09:12:44Z",
  "method": "POST",
  "path": "/",
  "query": "",
  "headers": [{ "name": "content-type", "value": "application/json" }],
  "body": "{\"reference\":\"ORD-104233\",\"amount\":25000,\"msisdn\":\"255745123456\",\"status\":\"COMPLETED\"}",
  "bodyEncoding": "text",
  "ip": "196.41.60.18",
  "status": "routed",
  "deliveryList": []
}

querystring

The query string, without the ?.

headersarray

The headers it was sent with, each { name, value }.

bodystring

The body, as text, or as base64 when bodyEncoding is base64.

bodyEncodingstring

text or base64.

ipstring

The address it was sent from.

deliveryListarray

Its deliveries, newest first.