Docs
API · webhooks

List webhooks

Return the webhook endpoints registered for the current project. Signing secrets are never echoed here — they appear only on create.

GET/v1/webhooks

01 Query parameters

cursorstringOptional
Opaque pagination cursor from a previous response's nextCursor.
limitintegerOptional
Page size, 1100 (default 25).
Project scopeWith an account-wide key, set X-Drin-Product to name the project whose endpoints you want. Project-scoped keys may omit it.

02 Request

curl https://api.drin.run/v1/webhooks \
  -H "Authorization: Bearer $DRIN_API_KEY"

03 Response

Returns 200 OK with a page of endpoints under data. signingSecret is an empty string on every endpoint — it is only ever returned on create.

200 OK
{
  "data": [
    {
      "id": "wh_3kQ9p2",
      "url": "https://example.com/hooks/drin",
      "enabled": true,
      "eventTypes": ["delivery", "bounce", "complaint"],
      "signingSecret": ""
    }
  ],
  "nextCursor": null
}