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

Query parameters

string

Opaque pagination cursor from a previous response’s nextCursor.

integer

Page size, 1–100 (default 25).

Project scope. With an account-wide key, set X-Drin-Product to name the project whose endpoints you want. Project-scoped keys may omit it.

Request

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

import { DrinClient } from "@drin00/sdk";

const drin = new DrinClient({ apiKey: process.env.DRIN_API_KEY });

const page = await drin.webhooks.list();
for (const hook of page.data) {
  console.log(hook.id, hook.url, hook.enabled);
}

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
}

Overview

Emails

Domains

Inboxes

Threads

Inbound

Webhooks

Suppressions

Contacts

Templates

Metrics

API keys

List webhooks

Query parameters

Request

Response

​Query parameters

​Request

​Response

Query parameters

Request

Response