API Reference

List Webhooks

GET /webhooks — list every webhook on your account.

GET/webhooks

Lists the webhooks on your account. This endpoint is always paginated: limit defaults to 20 (maximum 100) even when you do not send it. Keep paging with after while has_more is true.

Query parameters

limitnumberoptional

Number of webhooks to retrieve. Minimum 1, maximum 100, default 20.

afterstringoptional

The id after which to retrieve more webhooks (for pagination). Not included in the result. Cannot be combined with before.

beforestringoptional

The id before which to retrieve more webhooks (for pagination). Not included in the result. Cannot be combined with after.

import { Mailblastr } from 'mailblastr';

const mb = new Mailblastr('mb_xxxxxxxxx');

const { data, error } = await mb.webhooks.list();
console.log({ data, error });

Response

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "webhook",
      "id": "12",
      "created_at": "2026-06-10T10:15:30.000Z",
      "status": "disabled",
      "endpoint": "https://first-webhook.example.com/handler",
      "events": ["email.sent"],
      "has_secret": true,
      "last_delivery_at": null,
      "last_delivery_status": null,
      "failure_count": 0
    },
    {
      "object": "webhook",
      "id": "17",
      "created_at": "2026-06-22T15:28:00.000Z",
      "status": "enabled",
      "endpoint": "https://second-webhook.example.com/receive",
      "events": ["email.bounced"],
      "has_secret": true,
      "last_delivery_at": "2026-06-27T10:00:00.000Z",
      "last_delivery_status": 200,
      "failure_count": 0
    }
  ]
}