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
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"items":[{"data":{"ad_group_id":"3543281925","android_deep_link":"\u003cstring\u003e","carousel_android_deep_links":["\u003cstring\u003e","\u003cstring\u003e"],"carousel_destination_urls":["\u003cstring\u003e","\u003cstring\u003e"],"carousel_ios_deep_links":["\u003cstring\u003e","\u003cstring\u003e"],"click_tracking_url":"\u003cstring\u003e","creative_type":"VIDEO","destination_url":"\u003cstring\u003e","ios_deep_link":"\u003cstring\u003e","is_pin_deleted":"\u003cboolean\u003e","is_removable":"\u003cboolean\u003e","name":"\u003cstring\u003e","status":"ACTIVE","tracking_urls":{"impression":["\u003cstring\u003e","\u003cstring\u003e"],"click":["\u003cstring\u003e","\u003cstring\u003e"],"engagement":["\u003cstring\u003e","\u003cstring\u003e"],"buyable_button":["\u003cstring\u003e","\u003cstring\u003e"],"audience_verification":["\u003cstring\u003e","\u003cstring\u003e"]},"view_tracking_url":"\u003cstring\u003e","lead_form_id":"AG6","grid_click_type":"CLOSEUP","customizable_cta_type":"GET_OFFER","quiz_pin_data":{"questions":[{"question_id":"\u003cnumber\u003e","question_text":"\u003cstring\u003e","options":[{"id":"\u003cnumber\u003e","text":"\u003cstring\u003e"},{"id":"\u003cnumber\u003e","text":"\u003cstring\u003e"}]},{"question_id":"\u003cnumber\u003e","question_text":"\u003cstring\u003e","options":[{"id":"\u003cnumber\u003e","text":"\u003cstring\u003e"},{"id":"\u003cnumber\u003e","text":"\u003cstring\u003e"}]}],"results":[{"organic_pin_id":"\u003cstring\u003e","android_deep_link":"\u003cstring\u003e","ios_deep_link":"\u003cstring\u003e","destination_url":"\u003cstring\u003e","result_id":"\u003cnumber\u003e"},{"organic_pin_id":"\u003cstring\u003e","android_deep_link":"\u003cstring\u003e","ios_deep_link":"\u003cstring\u003e","destination_url":"\u003cstring\u003e","result_id":"\u003cnumber\u003e"}]},"pin_id":"519180","ad_account_id":"817742180","campaign_id":"8642","collection_items_destination_url_template":"\u003cstring\u003e","created_time":"\u003cinteger\u003e","id":"398","rejected_reasons":["AUTHENTICITY","PROHIBITED_PRODUCT"],"rejection_labels":["\u003cstring\u003e","\u003cstring\u003e"],"review_status":"APPROVED","type":"\u003cstring\u003e","updated_time":"\u003cinteger\u003e","summary_status":"DELETED_DRAFT"},"exceptions":{"code":"\u003cinteger\u003e","message":"\u003cstring\u003e"}},{"data":{"ad_group_id":"AG90653","android_deep_link":"\u003cstring\u003e","carousel_android_deep_links":["\u003cstring\u003e","\u003cstring\u003e"],"carousel_destination_urls":["\u003cstring\u003e","\u003cstring\u003e"],"carousel_ios_deep_links":["\u003cstring\u003e","\u003cstring\u003e"],"click_tracking_url":"\u003cstring\u003e","creative_type":"COLLECTION","destination_url":"\u003cstring\u003e","ios_deep_link":"\u003cstring\u003e","is_pin_deleted":"\u003cboolean\u003e","is_removable":"\u003cboolean\u003e","name":"\u003cstring\u003e","status":"DELETED_DRAFT","tracking_urls":{"impression":["\u003cstring\u003e","\u003cstring\u003e"],"click":["\u003cstring\u003e","\u003cstring\u003e"],"engagement":["\u003cstring\u003e","\u003cstring\u003e"],"buyable_button":["\u003cstring\u003e","\u003cstring\u003e"],"audience_verification":["\u003cstring\u003e","\u003cstring\u003e"]},"view_tracking_url":"\u003cstring\u003e","lead_form_id":"9370790895","grid_click_type":"CLOSEUP","customizable_cta_type":"SHOP_NOW","quiz_pin_data":{"questions":[{"question_id":"\u003cnumber\u003e","question_text":"\u003cstring\u003e","options":[{"id":"\u003cnumber\u003e","text":"\u003cstring\u003e"},{"id":"\u003cnumber\u003e","text":"\u003cstring\u003e"}]},{"question_id":"\u003cnumber\u003e","question_text":"\u003cstring\u003e","options":[{"id":"\u003cnumber\u003e","text":"\u003cstring\u003e"},{"id":"\u003cnumber\u003e","text":"\u003cstring\u003e"}]}],"results":[{"organic_pin_id":"\u003cstring\u003e","android_deep_link":"\u003cstring\u003e","ios_deep_link":"\u003cstring\u003e","destination_url":"\u003cstring\u003e","result_id":"\u003cnumber\u003e"},{"organic_pin_id":"\u003cstring\u003e","android_deep_link":"\u003cstring\u003e","ios_deep_link":"\u003cstring\u003e","destination_url":"\u003cstring\u003e","result_id":"\u003cnumber\u003e"}]},"pin_id":"91927966006","ad_account_id":"38334273","campaign_id":"18","collection_items_destination_url_template":"\u003cstring\u003e","created_time":"\u003cinteger\u003e","id":"931","rejected_reasons":["IMAGE_BEFORE_AFTER","OTHER"],"rejection_labels":["\u003cstring\u003e","\u003cstring\u003e"],"review_status":"REJECTED","type":"\u003cstring\u003e","updated_time":"\u003cinteger\u003e","summary_status":"ARCHIVED"},"exceptions":{"code":"\u003cinteger\u003e","message":"\u003cstring\u003e"}}]}