API Reference

Meta Ads / API Reference

meta_ads_replace_ad_image

Replace the image on an existing Meta ad, keeping its copy, link, page and CTA. Use this when you already have a public image URL. If the user has a file rather than a URL, call media_upload_start(ad=...) instead -- that shows them a drop zone and does all of this the moment they drop the file. Args: ad: Which ad -- its name, part of its name, or its ID. image_url: Public URL of the replacement image (required). account_id: Ad account ID. Leave blank to use the connected default.

This is a read-only tool: it returns replace ad image for your Meta Ads account. It changes nothing.

Ask Claude

You do not call this tool yourself. Ask for the outcome and the client picks the tool:

Replace ad image in my Meta Ads account for [ad], [image url].

It takes 2 required and 1 optional parameter.

Parameters

ParameterTypeRequiredDescription
adstringYesAd
image_urlstringYesImage Url
account_idstringNoAccount Id

Related Meta Ads tools

Before you can call it

This tool needs a connected Meta Ads account. The Meta Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.

Workflows that use this

Rather than calling tools one at a time, these skills run a whole procedure against the same account:

Start free — 30 tool calls a month

No card required. Connect Google Ads, Meta Ads, GA4 or Search Console and ask Claude for the outcome — it picks the tool.