Webhook endpoints

Create, list, and revoke the unique endpoints used by the FINAP request inbox.

POST/webhooks/endpoints

Service: Webhook Inbox
Billing: Free

Create an endpoint

label

string

Optional human label, 1–64 characters.

curl https://api.finap.uk/api/v1/webhooks/endpoints -X POST \
  -H "Authorization: Bearer $FINAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"label":"Checkout staging"}'

List endpoints

GET /webhooks/endpoints returns the account’s active capture endpoints. The operation is authenticated but does not consume balance.

curl https://api.finap.uk/api/v1/webhooks/endpoints \
  -H "Authorization: Bearer $FINAP_API_KEY"

Revoke an endpoint

DELETE /webhooks/endpoints/:id performs a soft revocation. The endpoint remains part of your account history, while its public capture URL immediately starts returning 404.

curl https://api.finap.uk/api/v1/webhooks/endpoints/endpoint_id -X DELETE \
  -H "Authorization: Bearer $FINAP_API_KEY"