create_ad_from_post

What it does

Parameters

• ad_account_id string required

  Meta ad account id (act_…), from list_ad_accounts

  Matches ^(act_)?\d{1,32}$

• adset_id string required

  The ad set the new ad goes in (list_adsets)

  Matches ^\d{1,40}$

• name string required

  The new ad's name

  1 to 255 characters

• advantage_plus object required

  Required: the Advantage+ creative enhancements, all explicit

  Fields (1)

  • opt_in array of strings required

    Enhancements turned ON; every other one is sent OFF. [] = all off

    One of enhance_cta, inline_comment, reveal_details_over_time, show_destination_blurbs, show_summary, text_optimizations, product_tags, optimize_website_destination, shop, product_browsing, browser_addons, image_brightness_and_contrast, image_templates, image_touchups, video_auto_crop, video_filtering

• object_story_id string optional

  A Facebook post: <pageId>_<postId> (list_posts)

  Matches ^\d{1,40}_\d{1,40}$

• instagram_media_id string optional

  An Instagram post (list_posts source instagram or ads)

  Matches ^\d{1,40}$

• instagram_user_id string optional

  Instagram post: the account that published it

  Matches ^\d{1,40}$

• page_id string optional

  Instagram post: the Facebook page linked to that account

  Matches ^\d{1,40}$

• call_to_action string optional

  Instagram post only: e.g. SHOP_NOW, LEARN_MORE

  up to 40 characters

• website_url string optional

  Instagram post only, with call_to_action

  up to 2,048 characters

• url_parameters string optional

  UTM parameters added to the post's link

  up to 1,000 characters

• status string optional

  Default PAUSED

  One of PAUSED, ACTIVE

Example

Your assistant calls it for you when you ask in your own words. What it sends (MCP tools/call, JSON-RPC 2.0):

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_ad_from_post",
    "arguments": {
      "ad_account_id": "act_1234567890",
      "adset_id": "120200000000000002",
      "name": "Nordlicht | Spring launch",
      "advantage_plus": {
        "opt_in": [
          "enhance_cta"
        ]
      }
    }
  }
}

The same call over HTTP with an API key, for an MCP client of your own (an assistant that signs in sends its OAuth token instead):

curl -X POST https://app.apogee.ad/mcp \
  -H "Authorization: Bearer $APOGEE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"create_ad_from_post","arguments":{"ad_account_id":"act_1234567890","adset_id":"120200000000000002","name":"Nordlicht | Spring launch","advantage_plus":{"opt_in":["enhance_cta"]}}}}'

Access and cost

In the REST API

The same thing for your own code, with an API key:

• Create action: POST /actions

Related tools

Actions: Each tool only prepares: it returns an action_id and what will change. Nothing changes until execute_action, after your explicit OK, within 24 hours. Created objects are paused unless you ask otherwise.

• pause_ad: Pauses ads.
• pause_adset: Pauses ad sets.
• activate_ad: Turns paused ads back on.
• activate_adset: Turns paused ad sets back on.
• update_budget: Sets new daily budgets for ad sets.
• scale_budget: Scales ad set budgets by a percentage (+100% at most per change).
• update_campaign_status: Pauses or turns on a whole campaign.
• update_adset_targeting: Changes an ad set's targeting.
• duplicate_ad: Copies an ad into other ad sets of the same ad account, keeping the same post (likes, comments, shares).
• duplicate_adset: Copies an ad set with its ads, each keeping its post; created paused.
• duplicate_campaign: Copies a campaign with its ad sets and ads; created paused.
• create_adset: A new ad set in an existing campaign, from scratch or copying another ad set's targeting and conversion; created paused.
• create_ad: A new ad on an existing post or creative; created paused.
• execute_action: Runs a prepared action (or a prepared campaign), once, after your explicit OK. Returns what was created.