Update multiple audiences at once

post

https://api.convert.com/api/v2/accounts/{account_id}/projects/{project_id}/audiences/bulk-update

Allows for changing the status (e.g., active, archived) of multiple audiences within a project simultaneously. Requires a list of audience IDs and the target status.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

account_id

integer

required

ID of the account that owns the retrieved/saved data

project_id

integer

required

ID of the project to which save/retrieved data is connected

Body Params

Contains a list of audience ids and the target status (e.g., 'active', 'archived') to apply to all of them.

Request body for bulk updating the status of multiple audiences.

array of integers

required

length between 1 and 100

A list of audience unique numerical identifiers to be affected by a bulk operation.

id*

status

string

enum

required

The status of an audience:

active: The audience is currently active and can be used for targeting experiences.
archived: The audience is no longer active and cannot be used for new experiences, but its definition and past usage data are preserved. Archived audiences can often be cloned. Knowledge Base: "Benefits of Archiving Unused Goals, Locations, and Audiences."

Allowed:

Responses

Language

Credentials

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Indicates the outcome of a bulk operation (e.g., bulk update or delete). Provides a general success message and an errors array listing any entities that could not be processed, along with the reason for failure for each.

defaultIndicates an error occurred while processing the request. The code provides an HTTP status code, message offers a human-readable explanation or an array of validation errors, and fields (if present) specifies which input fields were problematic.