> ## 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 an Amazon Ads ad group in a campaign for any sponsored ads product

Creates an Amazon Ads ad group in a campaign for any sponsored ads product. Use amazon\_ads\_list\_campaigns to find the campaign ID.

| | |
| - | - |
| **App** | Amazon Ads |
| **Operation ID** | `amazon_ads_create_ad_group` |
| **Type** | Action |
| **Connection** | `amazon_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 the Amazon Ads profile (advertiser + marketplace) to create the ad group in. |
| `ad_product` | string or SelectableOption | Yes | - | The Amazon ad product of the parent campaign. Options: SPONSORED\_PRODUCTS, SPONSORED\_BRANDS, SPONSORED\_DISPLAY, or SPONSORED\_TELEVISION. Must match the campaign's ad product. Sponsored Products requires a default\_bid. |
| `campaign_id` | string or SelectItem | Yes | - | The Amazon Ads campaign to create the ad group in. |
| `ad_group_name` | string | Yes | - | Name of the Amazon Ads ad group. |
| `state` | string or SelectableOption | No | `{'value': 'PAUSED', 'label': 'Paused'}` | Ad group state on creation. Options: ENABLED, PAUSED, DRAFT, or PROPOSED. Default: PAUSED. |
| `default_bid` | number | No | - | Default bid for targets in this ad group, in the profile's currency (for example 1.5 for \$1.50). Required for Sponsored Products; also used by Sponsored Display and Sponsored TV. |
| `bid` | object or string | No | - | Advanced alternative to default\_bid: the raw Amazon Ads API v1 bid object, sent as-is. Keys: defaultBid, baseBid, maxAverageBid, marketplaceSettings (per-marketplace defaultBid with currencyCode for global campaigns). Example: \{"defaultBid": 1.5} |
| `marketplace_scope` | string or SelectableOption | No | - | SINGLE\_MARKETPLACE or GLOBAL. Only send when needed (for example Sponsored Display single-marketplace ad groups); read-only for Sponsored Products and Sponsored Brands ad groups. |
| `marketplaces` | array of string or SelectableOption | No | - | Retail marketplaces for the ad group (for example US). Used with SINGLE\_MARKETPLACE scope where the ad product supports it. |
| `creative_type` | string or SelectableOption | No | - | Creative type for the ad group: IMAGE or VIDEO. Availability varies by ad product; leave unset unless the product requires it. |
| `start_date_time` | string | No | - | Optional ad group start as an ISO datetime or YYYY-MM-DD date. Not supported for Sponsored Products or Sponsored Brands ad groups. |
| `end_date_time` | string | No | - | Optional ad group end as an ISO datetime or YYYY-MM-DD date. Not supported for Sponsored Products or Sponsored Brands ad groups. |
| `tags` | array of object or string | No | - | Open-ended labels applied to the ad group, as a raw JSON array of \{"key": ..., "value": ...} objects. Example: \[\{"key": "team", "value": "growth"}] |

### 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 Amazon ad group details including the full ad group object.

**Fields**: `ad_group_id`, `ad_group_name`, `campaign_id`, `ad_product`, `state`, `ad_group`


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