Create Video Ad - Markifact

Creates a Pinterest video ad by uploading a video, creating a video Pin, then creating an ad from that Pin. By default the Pin is ad-only and the ad is created paused. Set pin_only=true to create only the video Pin.


App	Pinterest Ads
Operation ID	`pinterest_ads_create_video_ad`
Type	Action
Connection	`pinterest_ads` (required)
Credits per run	3
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 video Pin and ad in.
`update_type`	string or SelectableOption	Yes	-	Choose whether to create a single video ad or multiple at once. Options: single or bulk.
`ad_group_id`	string or SelectItem	No	-	Pinterest ad group ID to create the ad under. Required unless pin_only is true.
`ad_name`	string	No	-	Name of the Pinterest ad. Required unless pin_only is true.
`ad_status`	string or SelectableOption	No	`{'value': 'PAUSED', 'label': 'Paused'}`	Status when the ad is created. Options: ACTIVE or PAUSED. Default: PAUSED.
`video_url`	string	No	-	Video to upload for the Pin/ad. Accepts a direct video URL, Google Drive share link (set to ‘Anyone with the link’), or Markifact uploaded video. Markifact uploads it to Pinterest and waits for processing.
`cover_image_url`	string	No	-	Optional cover image URL for the video Pin. Pinterest requires a cover; when this is omitted, cover_image_key_frame_time is sent instead (default 0, the first frame).
`cover_image_key_frame_time`	integer	No	-	Optional video timestamp in seconds to use as the cover frame. Ignored when cover_image_url is set. Defaults to 0 (the first frame).
`pin_title`	string	No	-	Title for the Pinterest Pin. Up to 100 characters.
`pin_description`	string	No	-	Description for the Pinterest Pin. Up to 800 characters.
`destination_url`	string	No	-	Landing page URL for the Pin and ad click-through.
`board_id`	string or SelectItem	No	-	Board ID to save the Pin to. Required only when ad_only_pin is false.
`ad_only_pin`	boolean	No	`True`	Create the Pin as ad-only so it does not appear organically. Default true.
`pin_only`	boolean	No	`False`	Create only the Pinterest video Pin and skip ad creation. Default false.
`call_to_action`	string or SelectableOption	No	-	Optional Pinterest customizable CTA type, for example LEARN_MORE, SHOP_NOW, SIGN_UP.
`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: video_url, destination_url, pin_title or pin_description, plus ad_group_id and ad_name unless pin_only is true. Optional columns: cover_image_url, cover_image_key_frame_time, board_id, ad_only_pin, pin_only, ad_status, call_to_action, 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 and Pin IDs. Fields: ad_ids, pin_ids, created_count