> ## Documentation Index > Fetch the complete documentation index at: https://docs.markifact.com/llms.txt > Use this file to discover all available pages before exploring further. # Create Adset > Create a new Meta Ads ad set with budget, targeting, optimization, and promoted object settings Create a new Meta Ads ad set with budget, targeting, optimization, and promoted object settings. | | | | --------------------- | ----------------------- | | **App** | Meta Ads | | **Operation ID** | `meta_ads_create_adset` | | **Type** | Action | | **Connection** | `meta_ads` (required) | | **Credits per run** | 2 | | **Agent / MCP tool** | Yes | | **Requires approval** | Yes (write operation) | ## Inputs | Field | Type | Required | Default | Description | | ------------------------------------ | -------------------------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `account` | DynamicAccount | Yes | - | Ad account to use. Accepts account ID or option object; value may be with or without 'act\_' prefix (for example 'act\_1234567890' or '1234567890') | | `campaign_id` | string or SelectItem | Yes | - | Campaign ID where the ad set will be created | | `adset_name` | string | Yes | - | Ad set name shown in Ads Manager. Maximum 400 characters | | `status` | string or SelectableOption | No | - | Initial delivery status after creation. If omitted, runner defaults to PAUSED | | `destination_type` | string or SelectableOption | Yes | - | ODAX destination type. Must be compatible with optimization\_goal and promoted\_object fields | | `optimization_goal` | string or SelectableOption | Yes | - | Optimization goal used for delivery and learning. Must align with destination\_type and billing\_event | | `billing_event` | string or SelectableOption | Yes | - | Billing event used by Meta for charging/optimization. Must be valid for the selected goal | | `bid_strategy` | string or SelectableOption | No | - | Bid strategy. If omitted, runner defaults to LOWEST\_COST\_WITHOUT\_CAP | | `bid_amount` | number | No | - | Bid amount as an actual dollar value in the account currency, NOT in cents (e.g. pass 2.5 for \$2.50). Do not multiply by 100 — the backend converts to cents automatically. Required when bid\_strategy is COST\_CAP or LOWEST\_COST\_WITH\_BID\_CAP. | | `budget_type` | string or SelectableOption | No | - | Budget mode: CAMPAIGN (use campaign budget), DAILY, or LIFETIME | | `budget_value` | number | No | - | Budget amount as an actual dollar value in the account currency, NOT in cents (e.g. pass 25 for $25, 12.5 for $12.50). Do not multiply by 100 — the backend converts to cents automatically. Required for DAILY and LIFETIME; ignored for CAMPAIGN. | | `attribution_setting` | string or SelectableOption | No | - | Optional conversion attribution setting for optimization. Don't set this unless you know you need it; Meta's default attribution setting is typically recommended and sufficient for most use cases. If set, must be compatible with the selected optimization\_goal. | | `is_incremental_attribution_enabled` | boolean | No | - | Optional incremental attribution optimization flag. Omit this to let Meta use the standard attribution optimization behavior. If enabled, meta will ignore any attribution\_setting provided | | `start_time` | integer | No | - | Optional start date/time as Unix timestamp in seconds (UTC), for example 1735689600 | | `end_time` | integer | No | - | Optional end date/time as Unix timestamp in seconds (UTC). Required when budget\_type is LIFETIME | | `promoted_object` | object or string | No | - | The object this ad set promotes, as a Meta promoted\_object JSON object. Required for certain objectives (for example website/app conversions, page likes, product sales). Pass only the Meta fields you need; do not wrap them in any discriminator. Common keys: pixel\_id, custom\_event\_type, custom\_event\_str, page\_id, application\_id, object\_store\_url, product\_set\_id, product\_catalog\_id, offline\_conversion\_data\_set\_id, event\_id. custom\_event\_type must be a valid Meta CustomEventType value, for example PURCHASE, LEAD, COMPLETE\_REGISTRATION, ADD\_TO\_CART, INITIATED\_CHECKOUT, CONTENT\_VIEW, SUBSCRIBE, or OTHER (use OTHER with custom\_event\_str for a custom event). Example: \{"pixel\_id": "1234567890", "custom\_event\_type": "PURCHASE"} | | `targeting` | object or string | Yes | - | The Meta targeting spec for this ad set, as a JSON object sent to Meta as-is. Only geo\_locations is required. Every other key below is optional: omit any you don't explicitly need and Meta applies its own defaults (for example broad age range, all genders, automatic placements). Do not send keys just to restate Meta's defaults. Use the keys below as needed: - geo\_locations (required): object with any of countries (ISO 3166-1 alpha-2, e.g. \['US','GB']), regions (\[\{key}]), cities (\[\{key, radius, distance\_unit}]), zips (\[\{key}]), custom\_locations (\[\{latitude, longitude, radius, distance\_unit}]), geo\_markets (\[\{key, name}]). location\_types (e.g. \['home','recent']). - excluded\_geo\_locations: same shape as geo\_locations, to exclude areas. - age\_min (13-65), age\_max (13-65), omit for meta's default of 18-65+ - genders: \[1] for male, \[2] for female, omit for all. - locales: list of Meta locale IDs (languages). - interests / behaviors: lists of \{id, name} from Meta's targeting search. - flexible\_spec: list of AND-grouped objects, each with interests/behaviors/demographics arrays (OR within each); used for detailed targeting. - exclusions: object with interests/behaviors to exclude. - custom\_audiences / excluded\_custom\_audiences: lists of \{id} for saved, lookalike, or retargeting audiences. - publisher\_platforms: subset of \['facebook','instagram','messenger','audience\_network','threads']; omit for automatic (Advantage+) placements. - device\_platforms: \['mobile','desktop']. - facebook\_positions / instagram\_positions / messenger\_positions / audience\_network\_positions / threads\_positions: per-platform placement lists; only valid when the matching publisher platform is set. - targeting\_automation: object such as \{"advantage\_audience": 1} to enable Advantage+ audience. Example: \{"geo\_locations": \{"countries": \["US"]}, "age\_min": 25, "age\_max": 45, "genders": \[2], "interests": \[\{"id": "6003107902433", "name": "Yoga"}]} | | `dsa_beneficiary` | string | No | - | Optional DSA beneficiary text for EU ad transparency requirements | | `dsa_payor` | string | No | - | Optional DSA payor text for EU ad transparency requirements | ### SelectItem | Field | Type | Required | Default | Description | | ------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------- | | `value` | string | Yes | - | The value of the selectable item. | | `label` | string | Yes | - | The label of the selectable item, used for display purposes. If not provided, defaults to the value. | ### SelectableOption | Field | Type | Required | Default | Description | | ------- | ------ | -------- | ------- | ----------- | | `value` | string | Yes | - | | | `label` | string | Yes | - | | ## Output **Type**: `Dict` Returns created ad set details. **Fields**: `adset_id`, `adset_name`, `campaign_id`, `status`