API Reference

List Automations

GET /automations — list your automations, newest first.

GET/automations

Lists your automations, newest first. The list returns automation objects without steps, connections, or enrollments — retrieve a single automation for the full object. See Pagination for navigating with limit, after, and before.

Query parameters

limitnumberoptional

Number of automations to retrieve per page. Default 20, maximum 100, minimum 1.

afterstringoptional

The automation id after which more automations are retrieved (the next page). Cannot be combined with before.

beforestringoptional

The automation id before which more automations are retrieved (the previous page). Cannot be combined with after.

import { MailBlastr } from 'mailblastr';

const mb = new MailBlastr('mb_xxxxxxxxx');

const { data, error } = await mb.automations.list({ limit: 20 });
console.log({ data, error });

Response

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "automation",
      "id": "c9b16d4f-ba6c-4e2e-b044-6bf4404e57fd",
      "audience_id": "aud_3b1c...",
      "domain": "yourdomain.com",
      "name": "Welcome series",
      "trigger": "user.created",
      "status": "enabled",
      "created_at": "2026-06-23T10:00:00.000Z",
      "updated_at": "2026-06-23T10:00:00.000Z"
    }
  ]
}

Returns validation_error if limit is outside 1–100, if a cursor is malformed, or if both before and after are supplied. See Errors.