meta_ads_ad_sets_create
Create ad sets within existing Meta Ads campaigns. Specify targeting (geo locations, age ranges), daily budget, billing event, and optimization goal. Default status is PAUSED for operator review before activation.
Instructions
Creates a new ad set inside an existing campaign. Returns the new ad_set id. Mutating, reversible via rollback_apply (rollback sets status to PAUSED). Targeting is passed as a Meta targeting spec object; at minimum supply geo_locations and age bounds. Default initial status is PAUSED — only ACTIVE when the operator has confirmed spend. After creation, attach ads with meta_ads_ads_create.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account_id | No | Meta Ads account ID in the format 'act_XXXXXXXXXX' (e.g. 'act_1234567890'). Optional — falls back to META_ADS_ACCOUNT_ID from the configured credentials. The leading 'act_' prefix is required. | |
| campaign_id | Yes | Parent campaign ID. Must exist and not be DELETED. | |
| name | Yes | Ad set name, up to 400 characters. | |
| daily_budget | No | Daily budget in account currency minor units (cents for USD, yen for JPY). Required unless the parent campaign uses CBO; mutually exclusive with lifetime-budget settings on the same ad set. | |
| billing_event | No | What Meta charges for. Default IMPRESSIONS. The valid options depend on the optimization_goal — incompatible pairings are rejected by Meta. | |
| optimization_goal | No | What Meta optimises delivery for (e.g. REACH, LINK_CLICKS, OFFSITE_CONVERSIONS, LANDING_PAGE_VIEWS, THRUPLAY). Default REACH. Must be compatible with the parent campaign's objective. | |
| targeting | No | Meta targeting spec. Typical keys: geo_locations (e.g. {'countries': ['JP']}), age_min, age_max, genders, interests, custom_audiences. See Meta Marketing API targeting docs for the full schema. | |
| status | No | Initial status. Default PAUSED. Only ACTIVE after operator sign-off. | |
| bid_amount | No | Bid cap in account currency minor units. Required for bid-strategy optimization goals such as LINK_CLICKS with TARGET_COST. Omit for automatic bidding. |