Hoppa till innehållet

List the webhooks

GET/v1/webhooks

TypeScript sendora.webhooks.list()

Python sendora.webhooks.list()

Key sk_… a server key

Responses

200Every webhook of the server.

  • webhooksarray of objectrequired
    • 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 (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.

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.