Create a Meta campaign
ads_create_meta_campaignBuild a Meta campaign, ad set and ad, all PAUSED: an objective (traffic, engagement, awareness, video_views, lead_generation, conversions, app_promotion), a daily or lifetime budget in whole currency units (on the ad set, or on the campaign with budgetLevel campaign), start and end dates, an optional bid strategy, targeting from ads_list_targeting, and a creative: a new image, video or carousel (2-10 cards) with headline, body, description, callToAction and linkUrl, published as the Page and optionally as an Instagram account from ads_list_instagram_accounts; or an existing Page post or Instagram post to boost. Pass campaignId or adSetId to add to an existing campaign or ad set. Media are staged uploads ({ uploadId }) or HTTPS URLs. Set validateOnly true first to have Meta check it without creating anything. Before creating, confirm the objective, budget, dates, audience and creative with the user; nothing spends until ads_set_status activates it, which needs the user's explicit go-ahead. Reuse the same idempotencyKey when retrying.
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": {
"adAccountId": "<adAccountId>",
"objective": "<objective>",
"campaignName": "<campaignName>",
"creative": "<creative>",
"idempotencyKey": "<idempotencyKey>"
},
"name": "ads_create_meta_campaign"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bid | No | ||
| adName | No | ||
| budget | No | ||
| adSetId | No | ||
| endDate | No | ||
| pixelId | No | ||
| creative | Yes | ||
| platform | No | meta_ads, tiktok_ads or linkedin_ads. Needed only when the profile has more than one ad network and no accountId is given. | |
| accountId | No | The Facebook accountId from list_accounts. Without it, pass profileId to use that profile's Facebook connection. | |
| objective | Yes | ||
| profileId | No | A profileId from list_profiles. Optional when accountId is given, which names its profile; if both are given they must agree. | |
| startDate | No | ||
| targeting | No | ||
| campaignId | No | ||
| leadFormId | No | ||
| adAccountId | Yes | ||
| appStoreUrl | No | ||
| budgetLevel | No | ad_set | |
| campaignName | Yes | ||
| validateOnly | No | ||
| applicationId | No | ||
| idempotencyKey | Yes | A unique value per intended campaign, such as a UUID. Sent as the Idempotency-Key header. | |
| conversionEvent | No | ||
| instagramAccountId | No | ||
| specialAdCategories | No | ||
| specialAdCategoryCountries | No |