API Reference

Update audience

PATCH /audiences/:id — rename an audience.

PATCH/audiences/:id

Rename an audience. The only field accepted is name. Returns the updated audience object.

Body

namestringrequired

The new name for the audience. Must be non-empty.

Request

import { MailBlastr } from 'mailblastr';

const mb = new MailBlastr('mb_xxxxxxxxx');

const { data, error } = await mb.audiences.update('AUDIENCE_ID', { "name": "Beta Signups" });
console.log({ data, error });

Response

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

Omitting name (or sending an empty string) returns 422 missing_required_field. An unknown id returns 404 not_found. See Errors.