Skip to Content
Tool referenceCreate ad from Instagram post (use existing post)

Create ad from Instagram post (use existing post) (adsap_create_ad_from_ig_post)

Platform: Meta · Read or write: Write · Plan: Early Access · Consumes a task: Yes · Preview supported: Yes

What it does

Turns an existing Instagram post, video or reel into an ad inside an ad set you already have. This is the “Use existing post” option from Meta Ads Manager. The ad inherits the ad set’s budget, targeting and schedule, and it always starts paused. The first call is a preview; ask again to create it.

Parameters

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

NameTypeRequiredDescription
ad_account_idstringYesact_<digits>. The ad account that owns the ad set and the Instagram account.
ad_set_idstringYesThe EXISTING ad set to add the ad to. The ad inherits this ad set’s budget, targeting, and schedule: no new budget is set. Get it from adsap_list_ad_sets.
ig_account_idstringYesThe Instagram account that owns the post. Used to resolve the ad’s Facebook Page + Instagram identity. Get it from adsap_list_meta_assets (asset_type: “instagram_accounts”).
ig_media_idstringYesThe Instagram post / video / reel to promote. Get it from adsap_list_ig_media (the id field).
ad_namestringNoOptional name for the ad. Defaults to “IG post <ig_media_id>”.
call_to_action_typestringNoOptional call-to-action button enum (e.g. SHOP_NOW, LEARN_MORE, SIGN_UP). Omit to promote the post as-is with no added button.
page_idstringNoOptional Facebook Page id override. Normally resolved automatically from the Instagram account; only set this if auto-resolution can’t find the linked page.
dry_runbooleanNoPreview only: the request is validated and the resolved payload returned, nothing is created or changed.

Example prompts

  • “Boost my latest reel as an ad in the Engagement ad set.”
  • “Turn the Instagram post from Tuesday about the new collection into an ad with a Shop Now button.”
  • “Preview an ad made from my most recent post in the Retargeting ad set, then create it if it looks right.”

Notes

This tool does not create a campaign or an ad set. Pick an existing ad set, an Instagram post and the Instagram account first.

  • adsap_get_ad_library_snapshot: Show what an Ad Library ad ACTUALLY LOOKS LIKE (creative, copy, page name), in a SELF-CONTAINED card.
  • adsap_get_ad_preview: Render a pixel-accurate visual preview of an existing Meta ad (real Meta render; video ads also get an animated clip in the interactive…
  • adsap_get_creative_performance: Ranked creative performance analysis with fatigue detection.
  • adsap_get_import_status: Check progress of a Meta historical-asset import started with adsap_import_account_creatives: status, phase (images then videos)…
  • adsap_get_preview_clip: Fetch the animated placement-preview clip (recorded video of the real Meta preview) for an ad+placement previously rendered with…
  • adsap_get_upload_status: Check status of an async video upload.
  • adsap_import_account_creatives: Import ALL historical creative assets (images + videos) that already exist in a Meta ad account into the Adsap Creative Library.
  • adsap_list_creative_assets: List uploaded Meta creative images and videos in the ad account asset library.
  • adsap_list_drive_files: Browse Google Drive for creative image/video files to upload to Meta.
  • adsap_list_dropbox_files: Browse Dropbox for creative image/video files to upload to Meta.
  • adsap_list_ig_media: List an Instagram account’s recent media/posts (live from Meta): the posts, reels, and stories that can be promoted.
  • adsap_replace_ad_creative: DESTRUCTIVE.
  • adsap_search_ad_library: Search Meta’s public Ad Library for ads (competitor research / ad transparency).
  • adsap_upload_creative: Upload image/video from Google Drive or Dropbox to a Meta ad account.

Guide

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

Last updated on