Webhooks
More ways to use this page
List the webhooks
GET/v1/
TypeScript sendora
Python sendora
Key sk_… a server key
Responses
200Every webhook of the server.
webhooksarray of objectrequiredwebhookIdstring (uuid)requiredurlstringrequiredWhere the events are posted.
eventsarray of "delivered" | "bounced" | "deferred" | "spam_complaint" | "unsubscribed" | "cap_ requiredwarning" | "cap_ reached" | "inbound" streamIdstring (uuid) or nullrequiredThe one stream whose message events it receives; null for every stream.
enabledbooleanrequiredFalse while switched off in the dashboard; nothing is queued for it then.
inboundContent"full" | "reference"requiredHow the inbound event carries a received message: the parsed message, or a reference.
createdAtstring (date-time)requiredsecretsarray of objectrequiredThe live secrets, oldest first; every delivery is signed with each of them, the newest first in Sendora-Signature.
secretIdstring (uuid)requiredcreatedAtstring (date-time)required
Example (23 lines)
{
"webhooks": [
{
"webhookId": "7c1e4d2a-0b9f-4a3e-8d6c-5e2f1a9b8c70",
"url": "https://example.se/hooks/sendora",
"events": [
"delivered",
"bounced",
"spam_complaint"
],
"streamId": null,
"enabled": true,
"inboundContent": "full",
"createdAt": "2026-09-15T12:00:00.000Z",
"secrets": [
{
"secretId": "4a5b6c7d-8e9f-4a0b-8c1d-2e3f4a5b6c7d",
"createdAt": "2026-09-15T12:00:00.000Z"
}
]
}
]
}Errors
Every error answers error, the code, and message, a sentence for a person. A code that adds fields is shown in full below the table.
| Code | Status | Meaning |
|---|---|---|
unauthorized | 401 | The key is missing, malformed or revoked. |
wrong_ | 403 | The key is of the other kind: a server key (sk_) where an account key (ak_) is needed, or the reverse. The message names the kind the operation takes. |