Docs/API reference/Webhooks API

Webhooks API

Management endpoints to configure webhooks and inspect or retry their deliveries.

API· 4 min read

Endpoints

Webhooks are nested under an application and scope-bound to it. All routes require a bearer token.

Method	Path	Description
GET	…/applications/{application}/webhooks	List webhooks
POST	…/applications/{application}/webhooks	Create a webhook
DELETE	…/webhooks/{webhook}	Delete a webhook
GET	…/webhooks/{webhook}/deliveries	List deliveries
POST	…/deliveries/{delivery}/retry	Retry a delivery

Create a webhook

bash

curl -fsS -X POST \
  https://api.emitwave.com/api/platform/applications/<APP_ID>/webhooks \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/hooks/emitwave"}'

Deliveries are signed so your endpoint can verify authenticity, and outbound requests are guarded against SSRF — see the Webhooks concept page.

List deliveries

GET…/webhooks/{webhook}/deliveries

Returns the recorded delivery attempts for a webhook, including status, so you can audit what fired and when.

Retry a delivery

POST…/deliveries/{delivery}/retry

Manually re-attempts a single delivery. Failed deliveries are also retried automatically; use this when you want to force an immediate redelivery after fixing a receiver.

← Previous

Credentials

Errors