Hoppa till innehållet

Read a webhook

GET/v1/webhooks/{id}

TypeScript sendora.webhooks.get(webhookId)

Python sendora.webhooks.get(webhook_id)

Key sk_… a server key

Parameters

  • idin pathstring (uuid)required

    The webhook id.

Responses

200A webhook of this server.

  • webhookIdstring (uuid)required
  • urlstringrequired

    Where the events are posted.

  • eventsarray of "delivered" | "bounced" | "deferred" | "spam_complaint" | "unsubscribed" | "cap_warning" | "cap_reached" | "inbound"required
  • streamIdstring (uuid) or nullrequired

    The one stream whose message events it receives; null for every stream.

  • enabledbooleanrequired

    False while switched off in the dashboard; nothing is queued for it then.

  • inboundContent"full" | "reference"required

    How the inbound event carries a received message: the parsed message, or a reference.

  • createdAtstring (date-time)required
  • secretsarray of objectrequired

    The live secrets, oldest first; every delivery is signed with each of them, the newest first in Sendora-Signature.

    • secretIdstring (uuid)required
    • createdAtstring (date-time)required
Example (19 lines)
{
  "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.

CodeStatusMeaning
unauthorized401The key is missing, malformed or revoked.
wrong_token_kind403The 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.
not_found404No such webhook of this server.