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 readwriteadmin. 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

Apache-2.0 licensed · a Finnoto product