> ## 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** | 1 |
| **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. Does not apply to CONSIDERATION ad groups: their Pin clicks vs outbound clicks optimization cannot be set through the Pinterest API at all, only in Ads Manager. |
| `reporting_event` | string | No | - | Optional event to report on, sent as reporting\_event inside optimization\_goal\_metadata.conversion\_tag\_v3\_goal\_metadata. For example, INITIATE\_CHECKOUT with conversion\_event ADD\_TO\_CART. Pinterest validates the event and its compatibility with the conversion goal. Omit to use Pinterest's default reporting behavior. |
| `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`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.