Update an audience

PATCH/v1/audiences/{id}API key

The name is the only thing you can change on an audience. To change who is in it, use Add contacts and Remove contacts.

Body parameters

namestringrequired

The new name, 1 to 200 characters. Must be unique in the project.

Response

The renamed audience, with the fields described in Create an audience.

Errors

Status	Code	When
400	`invalid_body`	`name` is missing, empty or over 200 characters.
404	`audience_not_found`	No audience with that ID in this project.

Renaming to a name another audience already has is not turned into a clean 409 audience_exists the way Create an audience is. The database refuses it and the request fails with 500 internal_error. Pick a name that isn't taken.

Request

import { Flaresend } from '@flaresend/client';

const flaresend = new Flaresend({
  apiKey: process.env.FLARESEND_API_KEY!,
  baseUrl: 'https://mailer.example.com',
});

const audience = await flaresend.audiences.update('aud_01K6C2A7F3H5J8K1M4N6P9Q2RS', {
  name: 'Early access',
});

Response

{
  "id": "aud_01K6C2A7F3H5J8K1M4N6P9Q2RS",
  "projectId": "proj_01K5Z8W2Q4R6T8V0X2Z4B6D8FG",
  "name": "Early access",
  "contactCount": 42,
  "createdAt": "2026-09-26T10:05:00.000Z"
}

Path parametersCopy Anchor Link

Body parametersCopy Anchor Link

ResponseCopy Anchor Link

ErrorsCopy Anchor Link

Path parameters

Body parameters

Response

Errors