Skip to content

Send a webhook​

POST
/v1/send

Deliver one payload to a registered destination (or a validated ad-hoc HTTPS URL). Signed (Standard Webhooks), retried, circuit-broken, logged. Send Idempotency-Key to make client retries safe.

Authorizations​

apiKey

Scoped API key. Scopes are read ⊂ write ⊂ admin. A call needing more scope than the key holds returns 403 insufficient_scope.

Type
HTTP (bearer)

Parameters​

Header Parameters

Idempotency-Key

POST only. Duplicate requests with the same key within ~12–24 h return the original response and create no second effect.

Type
string
Format
"uuid"

Request Body​

application/json
JSON
{
  
"destination": "dst_01JX9",
  
"event_type": "invoice.created",
  
"payload": {
  
},
  
"headers": {
  
  
"additionalProperties": "string"
  
}
}

Responses​

Accepted — queued for delivery.

application/json
JSON
{
  
"message_id": "msg_01JX9"
}

Playground​

Authorization
Headers
Body

Samples​

Powered by VitePress OpenAPI

Emithook · a Finnoto product