Skip to main content
PUT
Updates the specified audience. All body parameters are optional — only the fields you include will be updated. If the filter is changed, the cached_size is cleared and must be recalculated using the Get Audience Size endpoint.

Path Parameters

string
required
The unique identifier of the audience to update.

Body Parameters

string
Updated audience name. Maximum 255 characters.
string
Updated audience description. Maximum 1000 characters. A longer value currently returns a 500 error rather than a validation error.
array of integers
Updated sending list IDs to scope the audience. Empty array means all lists.
object
Updated filter group definition. See the Audience Filter DSL reference for the full specification. Changing the filter clears the cached audience size.

Response Fields

The response is the full updated audience object (flat, not wrapped).
string
Unique audience identifier.
string
Audience name.
string
Audience description.
array of integers
Sending list IDs this audience is scoped to.
object
The filter group definition. Condition objects use camelCase keys (e.g. conditionType).
integer
Cached audience size. Reset to null if filter was changed.
datetime
Timestamp of last size calculation. Reset to null if filter was changed.
string
Audience status.
datetime
Timestamp when the audience was created.

Examples

Error Codes

Next Steps

Creating Audiences

Manage audience segments

Create Schedule

Schedule a campaign