Create Ad From Pin - Markifact

Promotes an existing Pinterest Pin as an ad in an ad group. Detects the right creative type from the Pin’s media unless one is provided. This operation does not upload media or create Pins; to create an ad from new media use pinterest_ads_create_single_image_ad, pinterest_ads_create_video_ad, or pinterest_ads_create_carousel_ad instead.


App	Pinterest Ads
Operation ID	`pinterest_ads_create_ad_from_pin`
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.
`update_type`	string or SelectableOption	Yes	-	Choose whether to promote a single Pin or multiple Pins at once. Options: single or bulk.
`ad_group_id`	string or SelectItem	No	-	Pinterest ad group ID to create the ad under.
`pin_id`	string	No	-	ID of the existing Pin to promote.
`ad_name`	string	No	-	Name of the Pinterest ad.
`ad_status`	string or SelectableOption	No	`{'value': 'PAUSED', 'label': 'Paused'}`	Status when the ad is created. Options: ACTIVE or PAUSED. Default: PAUSED.
`creative_type`	string or SelectableOption	No	-	Optional ad creative type. Omit to let Markifact detect it from the Pin’s media (image Pin: REGULAR, video Pin: VIDEO, carousel Pin: CAROUSEL). Set it explicitly only for special formats such as MAX_VIDEO, COLLECTION, or IDEA.
`destination_url`	string	No	-	Optional landing page URL override for the ad click-through. Defaults to the Pin’s link.
`call_to_action`	string or SelectableOption	No	-	Optional Pinterest customizable CTA type, for example LEARN_MORE, SHOP_NOW, SIGN_UP.
`lead_form_id`	string	No	-	Optional Pinterest lead form ID to create a lead ad.
`click_tracking_url`	string	No	-	Optional third-party click tracking URL.
`view_tracking_url`	string	No	-	Optional third-party impression tracking URL.
`android_deep_link`	string	No	-	Optional Android deep link URL.
`ios_deep_link`	string	No	-	Optional iOS deep link URL.
`return_detailed_results`	boolean	No	`False`	Bulk mode only. If true, returns per-row results and does not raise on partial failures.
`structured_data`	array (also accepts a comma-separated string)	No	-	Use only when update_type is bulk. Required columns: pin_id, ad_group_id, ad_name. Optional columns: ad_status, creative_type, destination_url, call_to_action, lead_form_id, click_tracking_url, view_tracking_url, android_deep_link, ios_deep_link.

SelectItem

Field	Type	Required	Default	Description
`value`	string	Yes	-	The value of the selectable item.
`label`	string	Yes	-	The label of the selectable item, used for display purposes. If not provided, defaults to the value.

SelectableOption

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-

Output

Type: Dict Returns created Pinterest ad IDs. Fields: ad_ids, created_count