Sign in

v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB
customer_segment

Create customer segments

Customer segments allow advertisers to define existing customers for Pinterest Performance+ campaigns. Customer segments are made up of audience lists.

post/ad_accounts/{ad_account_id}/customer_segments

Path parameters

ad_account_idstring required

Unique identifier of an ad account.

Request body

audience_idsstring[] required

Audience IDs included in the customer segment.

namestring required

Customer segment name.

Response

The request has succeeded.

ad_account_idstring

The ID of the ad account that this customer segment belongs to.

audience_idsstring[] required

Audience IDs included in the customer segment.

created_timeinteger

Customer segment created time. Unix timestamp in seconds.

idstring

Customer segment ID.

namestring required

Customer segment name.

status'ACTIVE' | 'DELETED'

Indicate targeting template is active or Deleted

updated_timeinteger

Customer segment updated time. Unix timestamp in seconds.