> ## 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**   | 2                            |
| **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`