API Reference

Create audience

POST /audiences — create a new contact list.

POST/audiences

Create a new audience. The only field is a name. Returns the new audience object with a generated id.

Body

namestringrequired

A name for the audience. Required and must be non-empty.

Request

import { MailBlastr } from 'mailblastr';

const mb = new MailBlastr('mb_xxxxxxxxx');

const { data, error } = await mb.audiences.create({ "name": "Registered Users" });
console.log({ data, error });

Response (201)

{
  "object": "audience",
  "id": "78261eea-8f8b-4381-83c6-79fa7120f1cf",
  "name": "Registered Users",
  "domain": null,
  "created_at": "2026-06-23T17:22:43.000Z"
}

Omitting name returns 422 missing_required_field. See Errors.