Create Ad

Advanced: creates a Pinterest ad from a raw ad payload sent to Pinterest as-is

Advanced: creates a Pinterest ad from a raw ad payload sent to Pinterest as-is. Use the dedicated operations first (pinterest_ads_create_single_image_ad, pinterest_ads_create_video_ad, pinterest_ads_create_carousel_ad, pinterest_ads_create_ad_from_pin); use this only for ad formats or fields they do not support, such as MAX_VIDEO, COLLECTION, QUIZ, or grid_click_type. To get a pin_id for new media, run a dedicated create operation with pin_only=true first.

App	Pinterest Ads
Operation ID	pinterest_ads_create_ad
Type	Action
Connection	pinterest_ads (required)
Credits per run	2
Agent / MCP tool	Yes
Requires approval	Yes (write operation)

Inputs

Field	Type	Required	Default	Description
account	DynamicAccount	Yes	-	Select Pinterest Ads account to create the ad in.
ad_payload	object or string	Yes	-	Advanced: raw Pinterest ad payload as a JSON object, sent to Pinterest as-is (POST /ad_accounts/{id}/ads). Required keys: ad_group_id, pin_id, and creative_type (REGULAR, VIDEO, MAX_VIDEO, CAROUSEL, COLLECTION, SHOWCASE, QUIZ, COLLAGE, IDEA, SHOPPING). To get a pin_id for new media, run pinterest_ads_create_single_image_ad, pinterest_ads_create_video_ad, or pinterest_ads_create_carousel_ad with pin_only=true. Common optional keys: name, status (ACTIVE/PAUSED, Pinterest defaults to ACTIVE), destination_url, customizable_cta_type, is_removable, lead_form_id, grid_click_type, is_dynamic_cta (bool) with cta_types (array of at least two from ADD_TO_CART, BUY_NOW, CONTACT_US, EXPLORE_MORE, GET_OFFER, LEARN_MORE, ORDER_NOW, SHOP_NOW, TAKE_A_PEEK, VISIT_SITE, and it must include the objective’s default CTA, VISIT_SITE for CONSIDERATION) to let Pinterest pick the CTA per placement and device instead of customizable_cta_type, carousel_destination_urls / carousel_android_deep_links / carousel_ios_deep_links (arrays, one entry per card), android_deep_link, ios_deep_link, click_tracking_url, view_tracking_url, disclosure_type and disclosure_url (pharma), is_carting, quiz_pin_data (for QUIZ ads). Example: {“ad_group_id”: “2680059592705”, “pin_id”: “813744226420795884”, “creative_type”: “MAX_VIDEO”, “name”: “Max width video”, “status”: “PAUSED”}

Output

Type: Dict

Returns the created Pinterest ad ID and payload identifiers.

Fields: ad_id, ad_group_id, pin_id, creative_type