API Reference

Meta Ads / API Reference

meta_create_image_ad

Use this when the user wants to create the image ad, not just upload the asset. Uploads or reuses an image, creates an image creative, and optionally creates a PAUSED ad when adset_id is supplied. Prefer generated_asset_id from the creative tools when the image was just created in chat. Source may be a local file path, public URL, data URI/raw base64 bytes, or existing image_hash. Requires page_id, message, and destination link.

This is a write tool: it creates image ad 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:

Create image ad in my Meta Ads account.

It takes 0 required and 14 optional parameters.

Parameters

ParameterTypeRequiredDescription
namestringNoName
page_idstringNoPage Id
messagestringNoMessage
linkstringNoLink
sourcestringNoSource
generated_asset_idstringNoGenerated Asset Id
filenamestringNoFilename
headlinestringNoHeadline
descriptionstringNoDescription
adset_idstringNoAdset Id
ad_namestringNoAd Name
statusstringNoStatus
call_to_action_typestringNoCall To Action Type
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 using MCP Ads