Update audience

PATCH {{baseUrl}}/ad_accounts/:ad_account_id/audiences/:audience_id

This endpoint is currently in beta and not available to all apps. Learn more.

Update (edit or remove) an existing targeting audience.

Request Body

{"ad_account_id"=>"549755885175", "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>"}}, "description"=>"string", "operation_type"=>"UPDATE"}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;ad_account_id&quot;:&quot;549755885175&quot;,&quot;id&quot;:&quot;1234&quot;,&quot;name&quot;:&quot;ACME Tools&quot;,&quot;audience_type&quot;:&quot;deserunt dolor Excepteur&quot;,&quot;description&quot;:&quot;People who love making quilts.&quot;,&quot;rule&quot;:{&quot;country&quot;:&quot;US&quot;,&quot;customer_list_id&quot;:&quot;5497558859876&quot;,&quot;engagement_domain&quot;:[&quot;www.somedomain.com&quot;],&quot;engagement_type&quot;:&quot;click&quot;,&quot;event&quot;:&quot;checkout&quot;,&quot;event_data&quot;:{&quot;currency&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;lead_type&quot;:&quot;Newsletter&quot;,&quot;line_items&quot;:{&quot;product_brand&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;product_category&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;product_id&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;product_name&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;product_price&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;product_quantity&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;product_variant&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;product_variant_id&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},&quot;order_id&quot;:&quot;X-151481&quot;,&quot;order_quantity&quot;:1,&quot;page_name&quot;:&quot;Our Favorite Pins on Pinterest.&quot;,&quot;promo_code&quot;:&quot;WINTER10&quot;,&quot;property&quot;:&quot;Athleta&quot;,&quot;search_query&quot;:&quot;boots&quot;,&quot;value&quot;:&quot;199.98&quot;,&quot;video_title&quot;:&quot;How to style your Parker Boots&quot;},&quot;percentage&quot;:30,&quot;pin_id&quot;:[&quot;34567&quot;],&quot;prefill&quot;:true,&quot;retention_days&quot;:30,&quot;seed_id&quot;:[&quot;2542620639259&quot;,&quot;2542620639261&quot;],&quot;url&quot;:[&quot;eu dolore&quot;,&quot;minim Excepteur&quot;],&quot;visitor_source_id&quot;:&quot;549755885175&quot;,&quot;event_source&quot;:{&quot;=&quot;:[&quot;web&quot;,&quot;mobile&quot;]},&quot;ingestion_source&quot;:{&quot;=&quot;:[&quot;tag&quot;]},&quot;engager_type&quot;:1,&quot;campaign_id&quot;:[&quot;626744528398&quot;],&quot;ad_id&quot;:[&quot;687201361754&quot;],&quot;objective_type&quot;:[&quot;AWARENESS&quot;],&quot;ad_account_id&quot;:&quot;549755885175&quot;},&quot;size&quot;:1000,&quot;status&quot;:&quot;culpa sed&quot;,&quot;type&quot;:&quot;audience&quot;,&quot;created_timestamp&quot;:1451431341,&quot;updated_timestamp&quot;:1451431341}