# Create An Ad Campaign

Source: https://docs.launchfastlegacyx.com/mcp/ads-changes/create-ad-campaign

Create a Sponsored Products campaign with keywords, product targets, or automatic targeting from your AI app. It goes live unless you start it paused.

> **This tool changes your Amazon Ads account**
> `create_ad_campaign` creates a campaign in your Amazon Ads account. The campaign can take a minute or two to build. Once built, it starts to spend, unless you start it paused. Launch Fast records each change with what changed, when, and which AI app made it. To undo a change, ask your AI app to undo it. It uses [`undo_ad_change`](https://docs.launchfastlegacyx.com/mcp/ads-changes/undo-ad-change). Launch Fast tells the assistant to confirm each change with you first, unless you named the change exactly. Your AI app may also ask before it runs a change tool.

| Field             | Value                                                                                                                                                                                               |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| MCP tool          | `create_ad_campaign`                                                                                                                                                                                |
| Behavior          | Makes a change in your Amazon Ads account. Marked destructive, so your AI app may ask before it runs. It creates a new campaign, which goes live and can start spend unless `start_paused` is true. |
| Cost              | Free                                                                                                                                                                                                |
| Permission        | **Change Amazon Ads** (Amazon Ads tools). Amazon verification is necessary.                                                                                                                         |
| Sign-in           | OAuth only. API keys cannot make Ads changes. Your last Amazon verification (the code from your authenticator app) must be from the last 30 days.                                                   |
| Ad type           | Sponsored Products only                                                                                                                                                                             |
| Amazon connection | Amazon Ads                                                                                                                                                                                          |
| App view          | None. The assistant shows the result as text and a table.                                                                                                                                           |

## What It Does

`create_ad_campaign` creates one Sponsored Products campaign with one ad group for your products. The campaign uses manual targeting (keywords or product targets) or auto targeting (Amazon picks the searches). You can also add negative keywords.

The build can take a minute or two. [`get_ad_changes`](https://docs.launchfastlegacyx.com/mcp/ads-changes/get-ad-changes) shows when it is done.

## When To Use It

Use it to launch ads for a new product. You can also use it to put the keywords that sell into their own exact-match campaign. To add keywords to a campaign that you have now, use [`add_ad_keywords`](https://docs.launchfastlegacyx.com/mcp/ads-changes/add-ad-keywords).

## Inputs

| Input               | Required        | Values                                                                                                                                          | Example                                           |
| ------------------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
| `name`              | Yes             | A new campaign name that no other campaign uses                                                                                                 | `SP Garlic Press Exact`                           |
| `asins`             | Yes             | 1 to 10 of your own ASINs                                                                                                                       | `["B0C1EXAMPL"]`                                  |
| `targeting`         | Yes             | `manual` (keywords or product targets) or `auto` (Amazon picks the searches)                                                                    | `manual`                                          |
| `daily_budget`      | Yes             | The daily budget, more than 0                                                                                                                   | `25`                                              |
| `default_bid`       | Yes             | The default bid of the ad group, more than 0                                                                                                    | `0.75`                                            |
| `bid_strategy`      | Yes             | Amazon dynamic bidding: `down_only`, `up_and_down`, or `fixed`                                                                                  | `down_only`                                       |
| `top_of_search_pct` | No              | A top of search bid adjustment, a whole percentage from 0 to 900                                                                                | `50`                                              |
| `keywords`          | No, manual only | Up to 200 keywords. Each has `keyword`, `match` (`exact`, `phrase`, or `broad`), and an optional `bid`. Without a bid, it uses the default bid. | `[{"keyword": "garlic press", "match": "exact"}]` |
| `product_targets`   | No, manual only | Up to 200 ASINs to show your ads on. Each has `asin` and an optional `bid`.                                                                     | `[{"asin": "B0D4EXAMPL"}]`                        |
| `negative_keywords` | No              | Up to 100 negatives. Each has `keyword` and `match` (`exact` or `phrase`).                                                                      | `[{"keyword": "electric", "match": "phrase"}]`    |
| `skus`              | No              | Only when the answer said that an ASIN has more than one SKU. The SKU you picked for each ASIN.                                                 | `[{"asin": "B0C1EXAMPL", "sku": "GP-STEEL-01"}]`  |
| `start_paused`      | No              | `true` to create the campaign paused. If not, it runs right away.                                                                               | `true`                                            |
| `marketplace`       | No              | Two letters, such as `US`, `CA`, `UK`, or `DE`. Give it only when you advertise in more than one marketplace.                                   | `US`                                              |
| `reason`            | No              | One line on why, up to 300 characters. Launch Fast saves it with the change. The default is "Asked for in chat."                                | `Launch ads for a new product`                    |

## What The Answer Contains

* A status: `applied`, `partly applied`, `not applied`, `going through`, or `unconfirmed`.
* A table row for the new campaign: its targeting, the number of keywords and product targets, the daily budget, and the result.
* The change id (it starts with `ac-`). Use it with [`get_ad_changes`](https://docs.launchfastlegacyx.com/mcp/ads-changes/get-ad-changes) and [`undo_ad_change`](https://docs.launchfastlegacyx.com/mcp/ads-changes/undo-ad-change).
* Notes about large changes, and the currency when it is not USD.
* A note when an ASIN has more than one SKU that can be advertised, with the SKUs to choose from.
* The day that the result is due, once two weeks of ads data are in. Ask for it then with [`get_ad_changes`](https://docs.launchfastlegacyx.com/mcp/ads-changes/get-ad-changes).

| Status           | Meaning                                                                                                                                                                                                                                                              |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `applied`        | All changes reached Amazon Ads.                                                                                                                                                                                                                                      |
| `partly applied` | Some changes reached Amazon Ads. The table shows what happened to the rest.                                                                                                                                                                                          |
| `not applied`    | Nothing changed in Amazon Ads. The table shows why.                                                                                                                                                                                                                  |
| `going through`  | Amazon was still applying the change when the answer came back. The answer waits up to 45 seconds. Launch Fast keeps applying the change, and if the call was cut off, it carries the change on within about 15 minutes. Check it in a minute with `get_ad_changes`. |
| `unconfirmed`    | Amazon accepted the change but then showed a different value. Check the value in Amazon Ads before you change it again.                                                                                                                                              |

## Example Prompts

```text
Create a manual exact-match campaign called SP Garlic Press Main for B0C1EXAMPL. Use a $25 daily budget, a $0.75 default bid, down only bidding, and my top three keywords.
```

```text
Start an auto campaign for my new product at $15 a day. Create it paused so I can check it first.
```

## Common Errors

| Error                                        | What it means                                                                                                                                                    | What to do                                                                                                                                                                                                                                                                           |
| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `invalid_input`: a value is missing          | `name`, `asins`, `targeting`, `daily_budget`, `default_bid`, or `bid_strategy` is missing or not valid.                                                          | Give all six values.                                                                                                                                                                                                                                                                 |
| `invalid_input`: a 10-character ASIN         | An ASIN in `asins`, `product_targets`, or `skus` is not a valid ASIN.                                                                                            | Give 10-character ASINs, such as `B0C1EXAMPL`.                                                                                                                                                                                                                                       |
| `invalid_input`: too many items              | More than 10 ASINs, more than 200 keywords or product targets, or more than 100 negatives.                                                                       | Use fewer items. After the campaign exists, add more exact or phrase keywords with [`add_ad_keywords`](https://docs.launchfastlegacyx.com/mcp/ads-changes/add-ad-keywords) and more negatives with [`add_negative_keywords`](https://docs.launchfastlegacyx.com/mcp/ads-changes/add-negative-keywords). For more than 10 ASINs, create another campaign. |
| `invalid_input`: top of search               | `top_of_search_pct` is not a whole number from 0 to 900.                                                                                                         | Give a whole percentage, such as `50`.                                                                                                                                                                                                                                               |
| `not applied`: more than one SKU             | An ASIN has more than one SKU that can be advertised. The answer lists the SKUs.                                                                                 | Choose one SKU for each of those ASINs. The assistant calls again with the same inputs plus `skus`.                                                                                                                                                                                  |
| `not applied`: other reasons                 | Launch Fast refused the campaign, for example because another campaign uses the name or an ASIN is not in your catalog for this ads account. The table says why. | Fix the input the table names, then try again.                                                                                                                                                                                                                                       |
| `oauth_required`                             | You connected Launch Fast with an API key. API keys cannot change Amazon Ads.                                                                                    | Add Launch Fast as a connector in your AI app and sign in. See [Getting started](https://docs.launchfastlegacyx.com/mcp/getting-started).                                                                                                                                                                              |
| `mfa_required`                               | Your last Amazon verification is more than 30 days old, or Amazon access for this app ended.                                                                     | Connect the app again and enter your authenticator code on the Launch Fast sign-in page. See [Authentication](https://docs.launchfastlegacyx.com/mcp/authentication#how-long-amazon-access-lasts).                                                                                                                     |
| `not_enabled`                                | Ad changes through Launch Fast are paused for now, or Amazon access for the app needs a fresh verification. The message says which.                              | For a fresh verification, verify again in [Settings > MCP & API keys](https://launchfastlegacyx.com/settings/mcp). For a pause, make the change in Amazon Ads.                                                                                                                       |
| `busy`                                       | Another change on this Amazon Ads account is in progress.                                                                                                        | Wait a minute and try again. Check the change with [`get_ad_changes`](https://docs.launchfastlegacyx.com/mcp/ads-changes/get-ad-changes).                                                                                                                                                                              |
| Rate limit: `amazon_ads rate limit exceeded` | Your account made more than 10 Ads change calls in one minute. The limit counts all the change tools together.                                                   | Wait the number of seconds in the message, then try again.                                                                                                                                                                                                                           |

## Related Tools

* [`research_keywords`](https://docs.launchfastlegacyx.com/mcp/research/research-keywords) finds keywords for a new product.
* [`get_ad_changes`](https://docs.launchfastlegacyx.com/mcp/ads-changes/get-ad-changes) shows when the campaign is done.
* [`undo_ad_change`](https://docs.launchfastlegacyx.com/mcp/ads-changes/undo-ad-change) archives the campaign. Amazon cannot bring back an archived campaign.