account | DynamicAccount | Yes | - | Select the Amazon Ads profile (advertiser + marketplace) to create the ad in. |
ad_product | string or SelectableOption | Yes | - | The Amazon ad product of the ad group. Options: SPONSORED_PRODUCTS, SPONSORED_BRANDS, SPONSORED_DISPLAY, or SPONSORED_TELEVISION. Sponsored Products ads use the simple product fields; other products take a raw creative object. |
ad_group_id | string or SelectItem | Yes | - | The Amazon Ads ad group to create the ad in. |
ad_type | string or SelectableOption | No | - | The ad format: PRODUCT_AD (Sponsored Products), COMPONENT (Sponsored Brands product collection, store spotlight, brand video, and other component formats), VIDEO, DISPLAY, AUDIO, or THIRD_PARTY. Defaults to PRODUCT_AD for Sponsored Products and COMPONENT for Sponsored Brands. |
ad_name | string | No | - | Name of the ad. Required for Sponsored Brands ads. |
state | string or SelectableOption | No | {'value': 'PAUSED', 'label': 'Paused'} | Ad state on creation. Options: ENABLED, PAUSED, DRAFT, PROPOSED. Default: PAUSED. |
product_id | string | No | - | For Sponsored Products PRODUCT_AD: the product to advertise, as an ASIN (like B07FZ8S74R) or SKU. Sellers use SKU; vendors use ASIN. |
product_id_type | string or SelectableOption | No | {'value': 'ASIN', 'label': 'ASIN'} | Whether product_id is an ASIN or SKU. Default: ASIN. |
headline | string | No | - | Optional custom headline text for the Sponsored Products ad. |
creative | object or string | No | - | Raw Amazon Ads API v1 creative object, sent as-is; required for every ad except Sponsored Products product ads (which can use product_id instead). Exactly one key: productCreative, componentCreative (Sponsored Brands: productCollectionSettings, storeSpotlightSettings, productVideoSettings, brandStoreSettings, and other component formats), videoCreative (onlineVideoSettings or streamingTvSettings for Sponsored TV), displayCreative, audioCreative, or thirdPartyCreative. Image and video assets are referenced by assetId + assetVersion from amazon_ads_upload_creative_asset or amazon_ads_search_assets. Example: {“componentCreative”: {“productVideoSettings”: {“products”: [{“productId”: “B003UKM9CO”, “productIdType”: “ASIN”}], “videos”: [{“assetId”: “amzn1…”, “assetVersion”: “version_v1”}]}}} |
tags | array of object or string | No | - | Open-ended labels applied to the ad, as a raw JSON array of {“key”: …, “value”: …} objects. Example: [{“key”: “team”, “value”: “growth”}] |