API Reference

List Webhooks

GET /webhooks — list every webhook on your account.

GET/webhooks

Lists all webhooks on your account. If you omit limit, all webhooks are returned in a single response.

Query parameters

limitnumberoptional

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

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": "7ab123cd-ef45-6789-abcd-ef0123456789",
      "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": "4dd369bc-aa82-4ff3-97de-514ae3000ee0",
      "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
    }
  ]
}