Meta ads: Build campaign
meta_build_campaignBuild a whole Meta (Facebook and Instagram) campaign in one step: the campaign, one ad set (goal, daily budget, locations, ages) and 1-5 ads (text, headline, button, link, with one image, a 2-10 image carousel or a video), all running from the client's Facebook Page. Everything is created inside a PAUSED campaign, so nothing spends until it is turned on (meta_set_campaign_status). Call WITHOUT confirm first: the preview downloads and checks every image and has Meta check the campaign. Show the preview to the user; only after they approve, call again with confirm: true to create it. The tool cannot activate anything. If a step fails partway, it deletes only the objects this same call just created (never an existing campaign, ad set or ad), so no half-built campaign is left. Goals: website_leads (needs pixel_id), landing_page_views, link_clicks, calls (needs a CALL_NOW button with phone_number), reach. Instant Forms (the form inside Facebook) are not available yet: send people to the client's site.
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": {
"ad_account_id": "<ad_account_id>",
"page_id": "<page_id>",
"name": "<name>",
"goal": "<goal>",
"daily_budget_major": "<daily_budget_major>",
"locations": "<locations>",
"ads": "<ads>"
},
"name": "meta_build_campaign"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ads | Yes | ||
| goal | Yes | ||
| name | Yes | Campaign name; the ad set and ads are named after it unless named | |
| age_max | No | ||
| age_min | No | ||
| confirm | No | Leave false to preview: nothing changes and the preview shows exactly what would happen. Set true only after the user has agreed to this exact change. | |
| page_id | Yes | The client's Facebook Page the ads run from (meta_list_pages) | |
| end_time | No | ||
| pixel_id | No | For website_leads: the pixel that fires a Lead event (meta_list_pixels) | |
| locations | Yes | Where the ads show: the area the client serves | |
| start_time | No | ISO date-time to start, e.g. 2026-11-10T08:00:00-0800 | |
| ad_account_id | Yes | 'act_...' from meta_list_accounts | |
| daily_budget_major | Yes | The ad set's daily budget in real currency (25 means $25.00/day) | |
| special_ad_categories | No | Required by Meta. Empty for ordinary home-service ads; HOUSING is for selling or renting homes, mortgages and home insurance |