> ## 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 Ad Group > Creates a Pinterest Ads ad group under a campaign with budget, bid, schedule, placement, and audience targeting Creates a Pinterest Ads ad group under a campaign with budget, bid, schedule, placement, and audience targeting. Budget and bid amounts are entered in the ad account currency and converted to Pinterest microcurrency automatically. | | | | --------------------- | ------------------------------- | | **App** | Pinterest Ads | | **Operation ID** | `pinterest_ads_create_ad_group` | | **Type** | Action | | **Connection** | `pinterest_ads` (required) | | **Credits per run** | 2 | | **Agent / MCP tool** | Yes | | **Requires approval** | Yes (write operation) | ## Inputs | Field | Type | Required | Default | Description | | -------------------------- | -------------------------- | -------- | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `account` | DynamicAccount | Yes | - | Select Pinterest Ads account to create the ad group in. | | `campaign_id` | string or SelectItem | Yes | - | Pinterest campaign ID to create the ad group under. | | `ad_group_name` | string | Yes | - | Name of the Pinterest ad group. | | `billable_event` | string or SelectableOption | Yes | - | What the advertiser is billed for. CLICKTHROUGH for clicks, IMPRESSION for impressions (CPM), VIDEO\_V\_50\_MRC for video views. | | `status` | string or SelectableOption | No | `{'value': 'PAUSED', 'label': 'Paused'}` | Status when the ad group is created. Options: ACTIVE, PAUSED, or DRAFT. Default: PAUSED. | | `budget_type` | string or SelectableOption | No | `{'value': 'DAILY', 'label': 'Daily'}` | Budget type. DAILY or LIFETIME require budget; LIFETIME also requires end\_time. Use CBO\_ADGROUP when the parent campaign uses Campaign Budget Optimization, which generates ad group budgets automatically; do not set budget with CBO\_ADGROUP. Default: DAILY. | | `budget` | number | No | - | Ad group budget in the ad account's currency (for example 20 for \$20). Markifact converts it to Pinterest microcurrency automatically. Required for DAILY and LIFETIME budget types. | | `bid` | number | No | - | Bid price in the ad account's currency, converted to microcurrency automatically. Pinterest requires it for these campaign objective and billable event combinations: AWARENESS with IMPRESSION, CONSIDERATION with CLICKTHROUGH, and CATALOG\_SALES with CLICKTHROUGH. | | `bid_strategy_type` | string or SelectableOption | No | - | Bid strategy. AUTOMATIC\_BID (Pinterest Performance+ bidding), MAX\_BID, or TARGET\_AVG. Video Completion campaigns only support AUTOMATIC\_BID. | | `start_time` | integer or string | No | - | Optional ad group start as a Unix timestamp or ISO datetime string. Must fall within the parent campaign schedule when that is set. | | `end_time` | integer or string | No | - | Optional ad group end as a Unix timestamp or ISO datetime string. Required for LIFETIME budgets and lifetime\_frequency\_cap. | | `auto_targeting_enabled` | boolean | No | `True` | Pinterest Performance+ targeting: let Pinterest expand the audience automatically. Default true. | | `targeting_spec` | object or string | No | - | Pinterest targeting spec as a JSON object with uppercase keys, sent to Pinterest as-is. Use the pinterest\_ads\_search\_targeting tool to find valid IDs for interests, locations, regions, languages, devices, and audiences. Omit for broad targeting; every key is optional: - GENDER: list from \["male","female","unknown"]. - MINIMUM\_AGE / MAXIMUM\_AGE: strings "18" to "65" ("65+" allowed for maximum only); must be used together. - LOCATION / LOCATION\_EXCLUDE: ISO two-letter country codes and/or metro codes, e.g. \["US","501"]. - GEO / GEO\_EXCLUDE: region codes like "US-CA" or postal codes like "94103" (one method per ad group). - LOCALE: ISO 639-1 language codes, e.g. \["en"]. - APPTYPE: devices from \["iphone","ipad","android\_mobile","android\_tablet","web","web\_mobile"]. - INTEREST: Pinterest interest IDs. - AUDIENCE\_INCLUDE / AUDIENCE\_EXCLUDE: audience IDs from pinterest\_ads\_list\_audiences (audiences need 100+ Pinterest users). - TARGETING\_STRATEGY: list from \["CHOOSE\_YOUR\_OWN","FIND\_NEW\_CUSTOMERS","RECONNECT\_WITH\_USERS"]. Example: \{"GENDER": \["female"], "MINIMUM\_AGE": "25", "MAXIMUM\_AGE": "54", "LOCATION": \["US"], "APPTYPE": \["iphone", "android\_mobile"]} | | `conversion_event` | string or SelectableOption | No | - | Conversion event to optimize for. Required for conversion campaigns (SALES, LEADS, or legacy WEB\_CONVERSION objectives), for example CHECKOUT, ADD\_TO\_CART, SIGNUP, or LEAD. | | `conversion_tag_id` | string | No | - | Pinterest conversion tag ID to attribute the conversion event to. | | `cpa_goal` | number | No | - | Optional CPA goal for conversion campaigns in the ad account's currency, converted to microcurrency automatically. | | `placement_group` | string or SelectableOption | No | - | Where ads appear: ALL (default), SEARCH, BROWSE, or OTHER. | | `pacing_delivery_type` | string or SelectableOption | No | - | Budget pacing. STANDARD (default) spends smoothly over the day; ACCELERATED spends as fast as possible and is not allowed with CBO\_ADGROUP. | | `lifetime_frequency_cap` | integer | No | - | Maximum impressions per person over a rolling 30 days. Only for IMPRESSION billable event ad groups, and requires end\_time. | | `is_creative_optimization` | boolean | No | `False` | Let Pinterest automatically turn product Pins into ads in different formats. Default false. | ### 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 Pinterest ad group details. **Fields**: `ad_group_id`, `ad_group_name`, `campaign_id`, `status`