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”}] |