upload_ad_image
Upload an image to Meta Ads creatives from a data URL, base64 string, or direct image URL, returning an image hash to use when building ad creatives.
Instructions
Upload an image to use in Meta Ads creatives.
Args:
account_id: Meta Ads account ID (format: act_XXXXXXXXX)
access_token: Meta API access token (optional - will use cached token if not provided)
file: Data URL or raw base64 string of the image (e.g., "data:image/png;base64,iVBORw0KG...")
image_url: Direct URL to an image to fetch and upload
name: Optional name for the image (default: filename)
Returns:
JSON object with:
- image_hash: Pass this to create_ad_creative when building the ad,
or to get_image_by_hash to view the image later.
- images: List of {hash, url, width, height, name}. The url is a
Meta CDN link you can fetch directly to view the image — no need
to call any other tool right after upload.
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": {
"account_id": "<account_id>"
},
"name": "upload_ad_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file | No | ||
| name | No | ||
| image_url | No | ||
| account_id | Yes | ||
| access_token | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |