Ads API •References / audiences / Edit an Audience

Edit an Audience

Edits an audience.

Request

audience_id
string [uuid]
Required
A unique identifier for the entity.
Example: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
ad_account_id
string [uuid]
Required
A unique identifier for an Ad Account.
Example: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a

Will be one of the following:

- audience_type
  string
  Required
  Type of the audience to edit.
  Example: "CUSTOM"
- name
  string
  Name of the audience.
  Length between 2 and 80Example: "US - 18-24 - All gender"
- description
  string
  Description of the audience.
  Maximum length: 80Example: "For spring promotion campaign"
- audience_type
  string
  Required
  Type of the audience to edit.
  Example: "CUSTOM"
- name
  string
  Name of the audience.
  Length between 2 and 80Example: "US - 18-24 - All gender"
- description
  string
  Description of the audience.
  Maximum length: 80Example: "For spring promotion campaign"

Response

An audience.

created_at
string [date-time]
Date the entity was created. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
Example: "2026-01-23T04:56:07Z"
updated_at
string [date-time]
Date the entity was updated. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ
Example: "2026-01-23T04:56:07Z"
id
string [uuid]
A unique identifier for the entity.
Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
name
string
Name of the audience.
Length between 2 and 80Example: "US - 18-24 - All gender"
description
string
Description of the audience.
Maximum length: 80Example: "For spring promotion campaign"
type
string
Type of the audience.
Default: "CUSTOM"Allowed values: "CUSTOM", "LOOKALIKE"
An approximate range of users in the audience.
- min
  integer
  Minimum of an approximate range of users in the audience.
  Minimum value: 0
- max
  integer
  Maximum of an approximate range of users in the audience.
  Minimum value: 0
status
string
Status of the audience.
Default: "PROCESSING"Allowed values: "ARCHIVED", "PROCESSING", "EMPTY", "LEARNING", "BOOKABLE", "LIVE"
sources
array of strings
Sources of the audience data.
Source of the audience data.
Default: "UNKNOWN"Allowed values: "UNKNOWN", "CUSTOMER_LIST", "AUDIENCE", "PIXEL", "CONVERSIONS_API"
seed_audience_id
string [uuid]
ID of the seed audience for the lookalike audience.
Supported content-type(s): Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
seed_audience_name
string
Name of the audience.
Length between 2 and 80Example: "US - 18-24 - All gender"
lookalike_audience_ids
array of strings
IDs of the lookalike audiences created from the current audience.
A unique identifier for the entity.
Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
Datasets associated with the web event custom audience.
- id
  string [uuid]
  A unique identifier for the entity.
  Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"
- name
  string
  The name of the dataset.
included_events
array of strings
Event names included in the web event custom audience.
Example: "ADDTOCART"
excluded_events
array of strings
Event names excluded from the web event custom audience.
Example: "PURCHASE"
lookback_days
integer
Lookback window for events in the web event custom audience.
Example: 30

Response sample

{ "created_at": "2026-01-23T04:56:07Z", "updated_at": "2026-01-23T04:56:07Z", "id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a", "name": "US - 18-24 - All gender", "description": "For spring promotion campaign", "type": "CUSTOM", "size": { "min": 0, "max": 0 }, "status": "PROCESSING", "sources": ["UNKNOWN"], "seed_audience_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a", "seed_audience_name": "US - 18-24 - All gender", "lookalike_audience_ids": ["ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"], "datasets": [ { "id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a", "name": "string" } ], "included_events": ["ADDTOCART"], "excluded_events": ["PURCHASE"], "lookback_days": 30}