Account Groups4

Account Settings9

Accounts16

Ad Accounts47

Ad Audiences7

Ad Campaigns50

Ad Creatives17

Ad Insights11

Ad Library1

Ad Targeting5

Analytics25

API Keys4

Blogs10

Broadcasts10

Business Agent55

Calls3

Comment Automations6

Comments15

Connect57

Connected Apps2

Contacts7

Conversions14

Custom Fields6

Discord24

GMB Attributes3

GMB Food Menus2

GMB Location Details2

GMB Media3

GMB Place Actions4

GMB Reviews5

GMB Services2

GMB Verifications4

iMessage17

Inbox Analytics7

Instagram5

Invites1

Lead Gen8

LinkedIn Mentions1

Logs1

Media1

Mentions2

Messages16

Messaging Ads3

Phone Numbers30

Posts10

Product Catalogs19

Products3

Profiles5

Queue6

Reach and Frequency4

Reddit Search2

Reviews3

Sequences10

Slack1

SMS22

Tools1

Tracking Tags10

Twitter Engagement8

Usage6

Users2

Validate4

Verify3

Voice18

Webhooks7

WhatsApp46

WhatsApp Calling16

WhatsApp Flows15

WhatsApp Phone Numbers16

WhatsApp Sandbox3

WhatsApp Templates1

Workflows14

Webhooks

Webhook Events55

Ad Audiences

Create custom audience

Create a custom audience. customer_list is supported on Meta, Google, X, LinkedIn, TikTok, and Pinterest; website and lookalike are Meta-only; company_list, engagement and website_retargeting are LinkedIn-only. saved_targeting stores a reusable TargetingSpec (no member upload, no adAccountId) that you reference later via savedTargetingId on POST /v1/ads/create.

How the audience gets filled depends on the type:

customer_list is created empty. Add members with POST /v1/ads/audiences/{audienceId}/users. On TikTok and Pinterest the audience is provisioned lazily on that first upload (until then its status is pending).
company_list is filled AT CREATION from the companies array below, which is required. To change the list afterwards send the new full list to POST /v1/ads/audiences/{audienceId}/companies (a replace, not a merge). The /users endpoint rejects these audiences with a 422.
website, website_retargeting, engagement, meta_engagement and lookalike fill themselves from the pixel, engagement source or seed audience you point them at. They take no member upload at all.

Create is not idempotent, never auto-retry.

post/v1/ads/audiences

Request body

Response

Audience created

audienceobject

messagestring

Changes

Changed in 8 of the 56 revisions of this API.2626

Sep 25, 20262c04683ce6942610See the full diff
- ▲
  the /////// request property type changed from object to no type
  request-property-type-changed
- ▲
  the /////// request property type changed from object to no type
  request-property-type-changed
- ●
  removed the request property ////////
  request-property-removed
- ●
  removed the request property ////////
  request-property-removed
- ●
  removed the request property ////////
  request-property-removed
- ●
  removed the request property ////////
  request-property-removed
- ●
  removed the request property ////////
  request-property-removed
- ●
  removed the request property ////////
  request-property-removed
- ○
  added subschema #1 subschema #2 to the /////// request property oneOf list
  request-property-one-of-added
- ○
  added subschema #1 subschema #2 to the /////// request property oneOf list
  request-property-one-of-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 16, 20263e6ddf2a99ea2See the full diff
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
Sep 15, 20260dba7d004d754See the full diff
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
Sep 14, 2026a23eb241746a2See the full diff
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  added the new optional request property ///////
  new-optional-request-property
Sep 10, 2026e70ed06e71502See the full diff
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
Sep 9, 2026222e3a38a3822See the full diff
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  added the new optional request property //////
  new-optional-request-property
Sep 2, 2026017dff7e43243See the full diff
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  added the new optional request property //////
  new-optional-request-property
- ○
  added the new optional request property //////
  new-optional-request-property
Aug 22, 202619fd2b70854e1See the full diff
- ○
  added the new optional request property /
  new-optional-request-property

Full history