Create custom audience

POST {{baseUrl}}/ad_accounts/:ad_account_id/audiences/custom

Create a custom audience and find the audiences you want your ads to reach.

Request Body

{"sharing_type"=>"CUSTOM", "name"=>"<string>", "rule"=>{"country"=>"<string>", "customer_list_id"=>"655", "engagement_domain"=>["<string>", "<string>"], "engagement_type"=>"<string>", "event"=>"<string>", "event_data"=>{"currency"=>"KRW", "lead_type"=>"<string>", "line_items"=>{"product_brand"=>"<string>", "product_category"=>"<string>", "product_id"=>"<integer>", "product_name"=>"<string>", "product_price"=>"<string>", "product_quantity"=>"<integer>", "product_variant"=>"<string>", "product_variant_id"=>"<string>"}, "order_id"=>"<string>", "order_quantity"=>"<integer>", "page_name"=>"<string>", "promo_code"=>"<string>", "property"=>"<string>", "search_query"=>"<string>", "value"=>"<string>", "video_title"=>"<string>"}, "percentage"=>"<integer>", "pin_id"=>["398", "44837"], "prefill"=>"<boolean>", "retention_days"=>"<integer>", "seed_id"=>["6230109537", "8"], "url"=>["<string>", "<string>"], "visitor_source_id"=>"81185876", "engager_type"=>"<integer>", "campaign_id"=>["927243", "97"], "ad_id"=>["827807", "96"], "objective_type"=>["VIDEO_VIEW", "CONSIDERATION"], "ad_account_id"=>"8"}, "data_party"=>"1p", "ad_account_id"=>"28730", "category"=>"<string>"}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;ad_account_id&quot;:&quot;34&quot;,&quot;id&quot;:&quot;540616&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;audience_type&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;rule&quot;:{&quot;country&quot;:&quot;\u003cstring\u003e&quot;,&quot;customer_list_id&quot;:&quot;017151893&quot;,&quot;engagement_domain&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;engagement_type&quot;:&quot;\u003cstring\u003e&quot;,&quot;event&quot;:&quot;\u003cstring\u003e&quot;,&quot;event_data&quot;:{&quot;currency&quot;:&quot;SEK&quot;,&quot;lead_type&quot;:&quot;\u003cstring\u003e&quot;,&quot;line_items&quot;:{&quot;product_brand&quot;:&quot;\u003cstring\u003e&quot;,&quot;product_category&quot;:&quot;\u003cstring\u003e&quot;,&quot;product_id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;product_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;product_price&quot;:&quot;\u003cstring\u003e&quot;,&quot;product_quantity&quot;:&quot;\u003cinteger\u003e&quot;,&quot;product_variant&quot;:&quot;\u003cstring\u003e&quot;,&quot;product_variant_id&quot;:&quot;\u003cstring\u003e&quot;},&quot;order_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;order_quantity&quot;:&quot;\u003cinteger\u003e&quot;,&quot;page_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;promo_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;property&quot;:&quot;\u003cstring\u003e&quot;,&quot;search_query&quot;:&quot;\u003cstring\u003e&quot;,&quot;value&quot;:&quot;\u003cstring\u003e&quot;,&quot;video_title&quot;:&quot;\u003cstring\u003e&quot;},&quot;percentage&quot;:&quot;\u003cinteger\u003e&quot;,&quot;pin_id&quot;:[&quot;36&quot;,&quot;57223&quot;],&quot;prefill&quot;:&quot;\u003cboolean\u003e&quot;,&quot;retention_days&quot;:&quot;\u003cinteger\u003e&quot;,&quot;seed_id&quot;:[&quot;475712&quot;,&quot;42311749575&quot;],&quot;url&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;visitor_source_id&quot;:&quot;921465&quot;,&quot;event_source&quot;:{},&quot;ingestion_source&quot;:{},&quot;engager_type&quot;:&quot;\u003cinteger\u003e&quot;,&quot;campaign_id&quot;:[&quot;3073443738&quot;,&quot;0626762932&quot;],&quot;ad_id&quot;:[&quot;732&quot;,&quot;5108076091&quot;],&quot;objective_type&quot;:[&quot;CATALOG_SALES&quot;,&quot;WEB_SESSIONS&quot;],&quot;ad_account_id&quot;:&quot;403239&quot;},&quot;size&quot;:&quot;\u003cinteger\u003e&quot;,&quot;status&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;\u003cstring\u003e&quot;,&quot;created_timestamp&quot;:&quot;\u003cinteger\u003e&quot;,&quot;updated_timestamp&quot;:&quot;\u003cinteger\u003e&quot;}