Webhook inbox events

Accept a public HTTP request, list captured traffic, and retrieve one event in full.

GET/webhooks/inbox

Service: Webhook Inbox
Billing: Free

Public capture endpoint

Send any HTTP method to /webhooks/inbox/:key. This receiver does not require a FINAP API key because the unguessable whk_ key identifies the inbox.

curl https://api.finap.uk/api/v1/webhooks/inbox/whk_capture_key \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"event":"payment.completed","id":"pay_0192"}'

List captured events

limit

query integer

Number of events to return. Defaults to 50 and is capped at 100.

curl "https://api.finap.uk/api/v1/webhooks/inbox?limit=50" \
  -H "Authorization: Bearer $FINAP_API_KEY"

Retrieve one event

GET /webhooks/inbox/events/:eventId returns the request method, stored headers and body, source IP, receive time, and recorded status.

id

string

Captured event identifier.

endpointId

string

Owning inbox endpoint.

method

string

Incoming HTTP method.

headers

Record<string, string>

Stored request headers without Authorization.

body

unknown

Parsed JSON or captured text.

ip / receivedAt

string | null

Source and receive timestamp metadata.