API Reference

Retrieve Webhook

GET /webhooks/:id — retrieve a single webhook.

GET/webhooks/:id

Retrieves a single webhook by id, including its status, endpoint, subscribed events, and delivery-health fields. The signing_secret is never returned on retrieval — it is only shown once, at creation or rotation.

Path parameters

idstringrequired

The webhook id as returned by Create Webhook or List Webhooks — a numeric string (e.g. 17), not a UUID. A non-numeric id returns not_found (404).

import { Mailblastr } from 'mailblastr';

const mb = new Mailblastr('mb_xxxxxxxxx');

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

Response

{
  "object": "webhook",
  "id": "17",
  "created_at": "2026-06-22T15:28:00.000Z",
  "status": "enabled",
  "endpoint": "https://example.com/handler",
  "events": ["email.sent"],
  "has_secret": true,
  "last_delivery_at": "2026-06-27T10:00:00.000Z",
  "last_delivery_status": 200,
  "failure_count": 0
}

Errors: not_found if the webhook does not exist or is not yours. See Errors.