Dashboard

Webhooks

List webhooks

List all webhooks on the connected account. Secrets are not returned; secret_prefix shows which secret a webhook was created with.

GEThttps://api.sndr.sh/api/cranl/v1/webhooks
List webhooks
curl 'https://api.sndr.sh/api/cranl/v1/webhooks' \
  -H 'Authorization: Bearer sndr_your_access_token'
200OK
{
  "data": [
    {
      "id":              "wh_2a7d4e9c-6b1",
      "organization_id": "org_8d41c7a2-3f6",
      "url":             "https://your-app.com/webhooks/sndr",
      "events":          ["email.delivered", "email.bounced", "email.failed"],
      "secret_prefix":   "whsec_Xk9pQ2",
      "active":          true,
      "created_at":      "2026-03-10T10:00:00Z"
    }
  ],
  "has_more": false,
  "count":    1,
  "limit":    1
}

Authorization

Authorizationstringheaderrequired

Bearer followed by an access token. Needs the read scope.

Errors

401unauthenticatedMissing or invalid Bearer token.
401token_expiredAccess token expired — exchange the refresh token for a new pair.
401token_revokedToken was explicitly revoked.
403insufficient_scopeToken is missing the read scope.