meta_ads_ad_sets_create
Create a new ad set under an existing campaign by specifying targeting, budget, and optimization goals. Returns the new ad set ID for attaching ads.
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. |