Create Ad
adsap_create_adCreate a Meta ad (image/video) in an ad set. Defaults to PAUSED. Creative: pass exactly ONE of creative_spec library filenames (feed_creative_name, or vertical_creative_name alone for a vertical-only ad, or a feed + vertical pair), image_hash / video_id (reuse an existing Meta image/video with new copy), creative_id (reuse a WHOLE existing creative as-is) or object_story_id (run an existing Page post as the ad) — the last two keep the original post and its likes/comments, and need no copy fields. ALWAYS call with dry_run: true first: it validates and renders a launch review card where the user confirms, creates (paused) and activates in-card — after it renders, reply with ONE short sentence and stop; do not call the real create from chat unless the user explicitly asks in a new message and the card's activity log shows nothing was created there. For App promotion (OUTCOME_APP_PROMOTION) ad sets: set link_url to the app's store URL (same as the ad set's promoted_object.object_store_url) and call_to_action to INSTALL_MOBILE_APP (or USE_MOBILE_APP/DOWNLOAD); the promoted app binding comes from the ad set. Shop (Meta sending people to the business's Facebook or Instagram shop instead of the website) is off unless the ad template or account_enhancements switches it on.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ad_set_id": "<ad_set_id>",
"ad_account_id": "<ad_account_id>",
"name": "<name>",
"ad_format": "<ad_format>",
"creative_spec": "<creative_spec>"
},
"name": "adsap_create_ad"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| status | No | ||
| dry_run | No | Validate only, no creation | |
| ad_format | Yes | ||
| ad_set_id | Yes | ||
| ad_account_id | Yes | ||
| creative_spec | Yes | ||
| idempotency_key | No |