Create ads

POST {{baseUrl}}/ad_accounts/:ad_account_id/ads

Create multiple new ads. Request must contain adgroupid, creativetype, and the source Pin pinid.

Request Body

{"0"=>{"ad_group_id"=>"AG102458", "pin_id"=>"43165", "creative_type"=>"SHOPPING", "android_deep_link"=>"<string>", "carousel_android_deep_links"=>["<string>", "<string>"], "carousel_destination_urls"=>["<string>", "<string>"], "carousel_ios_deep_links"=>["<string>", "<string>"], "click_tracking_url"=>"<string>", "destination_url"=>"<string>", "ios_deep_link"=>"<string>", "is_pin_deleted"=>"<boolean>", "is_removable"=>"<boolean>", "name"=>"<string>", "status"=>"ACTIVE", "tracking_urls"=>{"impression"=>["<string>", "<string>"], "click"=>["<string>", "<string>"], "engagement"=>["<string>", "<string>"], "buyable_button"=>["<string>", "<string>"], "audience_verification"=>["<string>", "<string>"]}, "view_tracking_url"=>"<string>", "lead_form_id"=>"4182649", "grid_click_type"=>"CLOSEUP", "customizable_cta_type"=>nil, "quiz_pin_data"=>{"questions"=>[{"question_id"=>"<number>", "question_text"=>"<string>", "options"=>[{"id"=>"<number>", "text"=>"<string>"}, {"id"=>"<number>", "text"=>"<string>"}]}, {"question_id"=>"<number>", "question_text"=>"<string>", "options"=>[{"id"=>"<number>", "text"=>"<string>"}, {"id"=>"<number>", "text"=>"<string>"}]}], "results"=>[{"organic_pin_id"=>"<string>", "android_deep_link"=>"<string>", "ios_deep_link"=>"<string>", "destination_url"=>"<string>", "result_id"=>"<number>"}, {"organic_pin_id"=>"<string>", "android_deep_link"=>"<string>", "ios_deep_link"=>"<string>", "destination_url"=>"<string>", "result_id"=>"<number>"}]}}}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;items&quot;:[{&quot;data&quot;:{&quot;ad_group_id&quot;:&quot;3543281925&quot;,&quot;android_deep_link&quot;:&quot;\u003cstring\u003e&quot;,&quot;carousel_android_deep_links&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;carousel_destination_urls&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;carousel_ios_deep_links&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;click_tracking_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;creative_type&quot;:&quot;VIDEO&quot;,&quot;destination_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;ios_deep_link&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_pin_deleted&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_removable&quot;:&quot;\u003cboolean\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;status&quot;:&quot;ACTIVE&quot;,&quot;tracking_urls&quot;:{&quot;impression&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;click&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;engagement&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;buyable_button&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;audience_verification&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},&quot;view_tracking_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;lead_form_id&quot;:&quot;AG6&quot;,&quot;grid_click_type&quot;:&quot;CLOSEUP&quot;,&quot;customizable_cta_type&quot;:&quot;GET_OFFER&quot;,&quot;quiz_pin_data&quot;:{&quot;questions&quot;:[{&quot;question_id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;question_text&quot;:&quot;\u003cstring\u003e&quot;,&quot;options&quot;:[{&quot;id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;text&quot;:&quot;\u003cstring\u003e&quot;},{&quot;id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;text&quot;:&quot;\u003cstring\u003e&quot;}]},{&quot;question_id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;question_text&quot;:&quot;\u003cstring\u003e&quot;,&quot;options&quot;:[{&quot;id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;text&quot;:&quot;\u003cstring\u003e&quot;},{&quot;id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;text&quot;:&quot;\u003cstring\u003e&quot;}]}],&quot;results&quot;:[{&quot;organic_pin_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;android_deep_link&quot;:&quot;\u003cstring\u003e&quot;,&quot;ios_deep_link&quot;:&quot;\u003cstring\u003e&quot;,&quot;destination_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;result_id&quot;:&quot;\u003cnumber\u003e&quot;},{&quot;organic_pin_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;android_deep_link&quot;:&quot;\u003cstring\u003e&quot;,&quot;ios_deep_link&quot;:&quot;\u003cstring\u003e&quot;,&quot;destination_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;result_id&quot;:&quot;\u003cnumber\u003e&quot;}]},&quot;pin_id&quot;:&quot;519180&quot;,&quot;ad_account_id&quot;:&quot;817742180&quot;,&quot;campaign_id&quot;:&quot;8642&quot;,&quot;collection_items_destination_url_template&quot;:&quot;\u003cstring\u003e&quot;,&quot;created_time&quot;:&quot;\u003cinteger\u003e&quot;,&quot;id&quot;:&quot;398&quot;,&quot;rejected_reasons&quot;:[&quot;AUTHENTICITY&quot;,&quot;PROHIBITED_PRODUCT&quot;],&quot;rejection_labels&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;review_status&quot;:&quot;APPROVED&quot;,&quot;type&quot;:&quot;\u003cstring\u003e&quot;,&quot;updated_time&quot;:&quot;\u003cinteger\u003e&quot;,&quot;summary_status&quot;:&quot;DELETED_DRAFT&quot;},&quot;exceptions&quot;:{&quot;code&quot;:&quot;\u003cinteger\u003e&quot;,&quot;message&quot;:&quot;\u003cstring\u003e&quot;}},{&quot;data&quot;:{&quot;ad_group_id&quot;:&quot;AG90653&quot;,&quot;android_deep_link&quot;:&quot;\u003cstring\u003e&quot;,&quot;carousel_android_deep_links&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;carousel_destination_urls&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;carousel_ios_deep_links&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;click_tracking_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;creative_type&quot;:&quot;COLLECTION&quot;,&quot;destination_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;ios_deep_link&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_pin_deleted&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is_removable&quot;:&quot;\u003cboolean\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;status&quot;:&quot;DELETED_DRAFT&quot;,&quot;tracking_urls&quot;:{&quot;impression&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;click&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;engagement&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;buyable_button&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;audience_verification&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;]},&quot;view_tracking_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;lead_form_id&quot;:&quot;9370790895&quot;,&quot;grid_click_type&quot;:&quot;CLOSEUP&quot;,&quot;customizable_cta_type&quot;:&quot;SHOP_NOW&quot;,&quot;quiz_pin_data&quot;:{&quot;questions&quot;:[{&quot;question_id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;question_text&quot;:&quot;\u003cstring\u003e&quot;,&quot;options&quot;:[{&quot;id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;text&quot;:&quot;\u003cstring\u003e&quot;},{&quot;id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;text&quot;:&quot;\u003cstring\u003e&quot;}]},{&quot;question_id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;question_text&quot;:&quot;\u003cstring\u003e&quot;,&quot;options&quot;:[{&quot;id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;text&quot;:&quot;\u003cstring\u003e&quot;},{&quot;id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;text&quot;:&quot;\u003cstring\u003e&quot;}]}],&quot;results&quot;:[{&quot;organic_pin_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;android_deep_link&quot;:&quot;\u003cstring\u003e&quot;,&quot;ios_deep_link&quot;:&quot;\u003cstring\u003e&quot;,&quot;destination_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;result_id&quot;:&quot;\u003cnumber\u003e&quot;},{&quot;organic_pin_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;android_deep_link&quot;:&quot;\u003cstring\u003e&quot;,&quot;ios_deep_link&quot;:&quot;\u003cstring\u003e&quot;,&quot;destination_url&quot;:&quot;\u003cstring\u003e&quot;,&quot;result_id&quot;:&quot;\u003cnumber\u003e&quot;}]},&quot;pin_id&quot;:&quot;91927966006&quot;,&quot;ad_account_id&quot;:&quot;38334273&quot;,&quot;campaign_id&quot;:&quot;18&quot;,&quot;collection_items_destination_url_template&quot;:&quot;\u003cstring\u003e&quot;,&quot;created_time&quot;:&quot;\u003cinteger\u003e&quot;,&quot;id&quot;:&quot;931&quot;,&quot;rejected_reasons&quot;:[&quot;IMAGE_BEFORE_AFTER&quot;,&quot;OTHER&quot;],&quot;rejection_labels&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;review_status&quot;:&quot;REJECTED&quot;,&quot;type&quot;:&quot;\u003cstring\u003e&quot;,&quot;updated_time&quot;:&quot;\u003cinteger\u003e&quot;,&quot;summary_status&quot;:&quot;ARCHIVED&quot;},&quot;exceptions&quot;:{&quot;code&quot;:&quot;\u003cinteger\u003e&quot;,&quot;message&quot;:&quot;\u003cstring\u003e&quot;}}]}