Create ad (`adsap_create_ad`)

Platform: Meta · Read or write: Write · Plan: All plans · Consumes a task: Yes · Preview supported: Yes

What it does

Creates a single image or single video ad inside an existing Meta ad set. You supply the creative: the asset, primary text, headline, description, call to action and destination URL. The ad starts paused. Ask for a preview first: the copilot validates the ad and shows a launch review card where you confirm, create and activate.

Parameters

Descriptions are shortened from the tool schema. Your assistant sees the full text.

Name	Type	Required	Description
`ad_set_id`	string	Yes
`ad_account_id`	string	Yes
`name`	string	Yes
`ad_format`	one of `SINGLE_IMAGE`, `SINGLE_VIDEO`	Yes
`creative_spec`	object	Yes
`creative_spec.page_id`	string	Yes
`creative_spec.instagram_user_id`	string	No	Instagram account id for Instagram placements. OPTIONAL: omit it when the brand has no Instagram account. Adsap then represents the brand on Instagram through its Facebook Page (Meta page-backed Instagram account), exactly like the Use Facebook Page option in Ads Manager.
`creative_spec.feed_creative_name`	string	Yes	Feed creative filename (1080x1080). Must exist in creative_metadata table.
`creative_spec.vertical_creative_name`	string	No	1080x1920 filename.
`creative_spec.horizontal_creative_name`	string	No	1200x628 filename.
`creative_spec.primary_texts`	array of string	Yes
`creative_spec.headlines`	array of string	Yes
`creative_spec.description`	string	No
`creative_spec.link_url`	string	No	Destination URL (https). Required unless awareness/engagement or lead gen.
`creative_spec.display_link`	string	No
`creative_spec.call_to_action`	one of `SHOP_NOW`, `LEARN_MORE`, `SIGN_UP`, `BOOK_NOW`, `CONTACT_US`, `DOWNLOAD`, `GET_OFFER`, `GET_QUOTE` and 11 more	Yes	CTA button. For profile visit ad sets (destination_type INSTAGRAM_PROFILE / FACEBOOK_PAGE / INSTAGRAM_PROFILE_AND_FACEBOOK_PAGE) the CTA is dictated by the destination: VIEW_INSTAGRAM_PROFILE (Instagram), VISIT_PROFILE (Facebook)…
`creative_spec.url_parameters`	string	No	UTM tags.
`creative_spec.deep_link`	string	No	Mobile deep link (e.g. myapp://product/123). App-promotion ads only: sent as the CTA’s app_link with app-store fallback (applink_treatment). Requires App Links / the Meta SDK configured in the promoted app.
`creative_spec.partnership_page_id`	string	No
`creative_spec.partnership_instagram_user_id`	string	No
`creative_spec.threads_page_id`	string	No
`creative_spec.ad_template_id`	string	No
`creative_spec.product_tags`	array of string	No
`creative_spec.catalog_id`	string	No
`creative_spec.catalog_name`	string	No
`creative_spec.product_set_id`	string	No
`creative_spec.product_set_name`	string	No
`creative_spec.leadgen_form_id`	string	No
`creative_spec.multi_advertiser_opt_in`	boolean	No	Default true.
`creative_spec.account_enhancements`	any	No
`creative_spec.ad_schedule_start`	string	No
`creative_spec.ad_schedule_end`	string	No
`status`	one of `PAUSED`, `ACTIVE`	No
`dry_run`	boolean	No	Preview only: the request is validated and the resolved payload returned, nothing is created or changed.
`idempotency_key`	string	No

Example prompts

“Create a video ad in the Retargeting ad set using the summer-hero clip, headline ‘Free shipping this week’, linking to our sale page.”
“Make an image ad from the blue-sneaker asset with three primary text variations and a Shop Now button.”
“Preview an ad for the App Installs ad set that sends people to the App Store listing.”

Notes

For App promotion ad sets, the link is the app store URL and the call to action is Install Mobile App.

adsap_get_ad_review_status: Check review and policy status of all active (optionally paused) ads in an account.
adsap_get_ad_status: Check the current delivery, review, and effective status of a single Meta ad.
adsap_list_ad_accounts: List Meta ad accounts the user manages.

Guide

Read Building the ads for the workflow around this tool, and the Tool reference for every tool.

Create ad (adsap_create_ad)