Meta Ads / API Reference
meta_upload_ad_image
First-choice image upload tool for Meta Ads. Use this when the user says upload an image, attached a photo, pasted a public image URL, or wants an image available in the Meta library. If the user gives a public URL, pass that URL directly to this tool instead of refusing to fetch it yourself. If the user attached a file, pass the attachment as data URI/raw base64 bytes in source. Accepts source as a local file path (e.g. /path/to/ad.png or C:\Users\me\ad.jpg), public URL, data URI/raw base64 bytes, existing image_hash, or generated_asset_id. account_id is the primary parameter; ad_account_id is also accepted as a legacy alias. Returns image_hash for creatives. Does not create a creative or ad.
This is a write tool: it uploads ad image in your Meta Ads account. Claude asks you to confirm before it runs.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Upload ad image in my Meta Ads account.
It takes 0 required and 5 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
source | string | No | Source |
generated_asset_id | string | No | Generated Asset Id |
filename | string | No | Filename |
account_id | string | No | Account Id |
ad_account_id | string | No | Ad Account Id |
Related Meta Ads tools
meta_upload_ad_videometa_ads_ab_test_resultsmeta_ads_account_change_historymeta_ads_account_diagnosticsmeta_ads_account_spending_limitmeta_ads_ad
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: