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.

import { MailBlastr } from 'mailblastr';

const mb = new MailBlastr('mb_xxxxxxxxx');

const { data, error } = await mb.webhooks.get('4dd369bc-aa82-4ff3-97de-514ae3000ee0');
console.log({ data, error });

Response

{
  "object": "webhook",
  "id": "4dd369bc-aa82-4ff3-97de-514ae3000ee0",
  "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.