Create audience
POST {{baseUrl}}/ad_accounts/:ad_account_id/audiences
Create an audience you can use in targeting for specific ad groups. Targeting combines customer information with the ways users interact with Pinterest to help you reach specific groups of users; you can include or exclude specific audienceids when you create an ad group.
For more, see <a class=reference external
href=https://help.pinterest.com/en/business/article/audience-targeting
target="blank">Audience targeting.
Request Body
{"audience_type"=>"ACTALIKE", "name"=>"string", "rule"=>{"country"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "customer_list_id"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "engagement_domain"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "engagement_type"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "event"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "event_data"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "percentage"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "pin_id"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "prefill"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "retention_days"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "seed_id"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "url"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "visitor_source_id"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "event_source"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "ingestion_source"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "engager_type"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "campaign_id"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "ad_id"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "objective_type"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "ad_account_id"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}}, "ad_account_id"=>"549755885175", "description"=>"string"}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"ad_account_id":"549755885175","id":"1234","name":"ACME Tools","audience_type":"amet sed consectetur sit","description":"People who love making quilts.","rule":{"country":"US","customer_list_id":"5497558859876","engagement_domain":["www.somedomain.com"],"engagement_type":"click","event":"checkout","event_data":{"currency":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"lead_type":"Newsletter","line_items":{"product_brand":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"product_category":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"product_id":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"product_name":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"product_price":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"product_quantity":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"product_variant":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"product_variant_id":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"order_id":"X-151481","order_quantity":1,"page_name":"Our Favorite Pins on Pinterest.","promo_code":"WINTER10","property":"Athleta","search_query":"boots","value":"199.98","video_title":"How to style your Parker Boots"},"percentage":30,"pin_id":["34567"],"prefill":true,"retention_days":30,"seed_id":["2542620639259","2542620639261"],"url":["velit Ut tempor","Duis"],"visitor_source_id":"549755885175","event_source":{"=":["web","mobile"]},"ingestion_source":{"=":["tag"]},"engager_type":1,"campaign_id":["626744528398"],"ad_id":["687201361754"],"objective_type":["AWARENESS"],"ad_account_id":"549755885175"},"size":1000,"status":"nisi Duis voluptate","type":"audience","created_timestamp":1451431341,"updated_timestamp":1451431341}