> ## 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

> Creates an Amazon Ads ad in an ad group: Sponsored Products product ads, or creative-based ads for Sponsored Brands, Display, and TV

Creates an Amazon Ads ad in an ad group: Sponsored Products product ads, or creative-based ads for Sponsored Brands, Display, and TV. Use amazon\_ads\_upload\_creative\_asset or amazon\_ads\_search\_assets for creative assets.

|                       |                         |
| --------------------- | ----------------------- |
| **App**               | Amazon Ads              |
| **Operation ID**      | `amazon_ads_create_ad`  |
| **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 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"}]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

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

**Fields**: `ad_id`, `ad_name`, `ad_group_id`, `ad_product`, `ad_type`, `state`, `ad`