create_adset
Create a Meta Ads ad set by supplying campaign ID, budget, targeting, optimization goal, and billing event. New ad sets default to PAUSED status.
Instructions
Create a new ad set. Requires name, campaign_id, budget, optimization_goal, billing_event, and targeting. Defaults to PAUSED status.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Ad set name | |
| status | No | Ad set status (default PAUSED) | PAUSED |
| end_time | No | End time (ISO 8601) | |
| dsa_payor | No | Who pays for the ad (legal entity name). Required with dsa_beneficiary for EU-delivering ad sets (DSA) | |
| targeting | Yes | JSON string of targeting spec (age_min, age_max, genders, geo_locations, interests, etc.) | |
| bid_amount | No | Bid cap / target cost in currency cents. Required by Meta when the effective bid strategy is LOWEST_COST_WITH_BID_CAP or COST_CAP | |
| start_time | No | Start time (ISO 8601) | |
| campaign_id | Yes | Parent campaign ID | |
| bid_strategy | No | Bid strategy: LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, COST_CAP, LOWEST_COST_WITH_MIN_ROAS | |
| daily_budget | No | Daily budget in currency cents (e.g. '5000' = $50.00) | |
| billing_event | Yes | Billing event: IMPRESSIONS, LINK_CLICKS, APP_INSTALLS, THRUPLAY | |
| dsa_beneficiary | No | Who benefits from the ad (legal entity name, shown in the EU Ad Library). Required by Meta for any ad set delivering into the EU (DSA) | |
| lifetime_budget | No | Lifetime budget in currency cents | |
| promoted_object | No | JSON string of the promoted object. Required for LEAD_GENERATION ({"page_id":"..."}) and OFFSITE_CONVERSIONS ({"pixel_id":"...","custom_event_type":"..."}) | |
| optimization_goal | Yes | Optimization goal: IMPRESSIONS, REACH, LINK_CLICKS, LANDING_PAGE_VIEWS, OFFSITE_CONVERSIONS, APP_INSTALLS, LEAD_GENERATION, VALUE, THRUPLAY, ENGAGED_USERS |