> ## Documentation Index
> Fetch the complete documentation index at: https://hyperfx.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Amazon Ads

> Set up and use the Amazon Ads integration with Hyper AI for Sponsored Products, Sponsored Brands, and campaign management

The Amazon Ads integration lets your agents and workflows manage Amazon advertising campaigns end-to-end — portfolios, campaigns, ad groups, product ads, keywords, and negative keywords.

Auth type: OAuth

<Info>
  For how integrations work overall (permissions, authentication, troubleshooting), see the main guide: [App Integrations](/integrations/overview).
</Info>

## Connect Amazon Ads

1. Go to **Settings → Apps** in Hyper
2. Select **Amazon Ads → Connect New**
3. Authorize with Amazon Ads — grant access to the seller / vendor accounts you want Hyper to manage

You can connect multiple Amazon Ads accounts and choose which one a given agent or flow uses.

## Common capabilities

* **Profiles** — list every Amazon Ads profile your account has access to
* **Portfolios** — list, create, update
* **Campaigns** — list, create, update, delete
* **Ad groups** — list, create, update, delete
* **Product ads** — list, create, update, delete
* **Keywords** — list, create, update, delete
* **Negative keywords** — list, create, delete (both at the ad group and campaign level)

## Use in Chat

1. In a chat, open the tool selector and enable Amazon Ads
2. Ask your agent to manage your campaigns

Example prompt:

```text theme={null}
For our top 5 Sponsored Products campaigns by spend in the last 7 days, find the search terms with ACOS over 100% and add them as negative keywords. Also raise bids by 10% on keywords with ACOS under 25%. Show me what you changed before and after.
```

## Use in Agents

In `Agents → Settings`, add Amazon Ads to an e-commerce or paid-media agent. Toggle approval on `delete_campaigns`, `delete_ad_groups`, and similar destructive actions.

## Use in Flows

Add Amazon Ads nodes for daily campaign hygiene: pull search-term reports → identify wasted spend → create negative keywords → log changes to Sheets.

## Troubleshooting

* **No profiles found**: confirm the Amazon account you authorized actually has Amazon Ads accounts attached. If you manage multiple profiles, list them first
* **403 / unauthorized**: Amazon Ads tokens occasionally expire — disconnect and reconnect
* **Campaign won't update**: certain fields (e.g., budget type, targeting type) can't be changed after creation

***

## Available Actions

Hyper agents can run the following actions for this integration. Each action can be individually set to **Enabled**, **Requires Approval**, or **Disabled** in your agent's toolkit settings.

Actions can be set to one of three control states:

| State                 | Behavior                                                       |
| --------------------- | -------------------------------------------------------------- |
| **Enabled**           | Agent runs the action automatically                            |
| **Requires Approval** | Agent pauses and waits for your confirmation before proceeding |
| **Disabled**          | Action is blocked and cannot be used                           |

Configure these in the agent's toolkit settings or in workspace defaults.

| Action                           | Description                                                                                     |
| -------------------------------- | ----------------------------------------------------------------------------------------------- |
| Create Ad Group                  | Create an ad group within a Sponsored Products campaign                                         |
| Create Budget Rule               |                                                                                                 |
| Create Campaign                  |                                                                                                 |
| Create Campaign Negative Keyword |                                                                                                 |
| Create Keyword                   |                                                                                                 |
| Create Negative Keyword          |                                                                                                 |
| Create Negative Product Target   |                                                                                                 |
| Create Portfolio                 | Create a new portfolio for an Amazon Ads profile                                                |
| Create Product Ad                |                                                                                                 |
| Create Product Target            |                                                                                                 |
| Create Report                    |                                                                                                 |
| Delete Ad Group                  | Archive (delete) an ad group                                                                    |
| Delete Campaign                  | Archive (delete) a Sponsored Products campaign by setting its state to archived                 |
| Delete Campaign Negative Keyword | Remove a campaign-level negative keyword                                                        |
| Delete Keyword                   | Archive (delete) a keyword                                                                      |
| Delete Negative Keyword          | Remove an ad-group level negative keyword                                                       |
| Delete Negative Product Target   | Remove a negative product target                                                                |
| Delete Product Ad                | Archive (delete) a product ad                                                                   |
| Delete Product Target            | Archive (delete) a product target                                                               |
| Get Bid Recommendations          |                                                                                                 |
| Get Category Recommendations     | Get recommended product categories for targeting based on a list of ASINs                       |
| Get Health Check                 |                                                                                                 |
| Get Report Status                |                                                                                                 |
| List Ad Groups                   | List ad groups within a Sponsored Products campaign                                             |
| List Budget Rules                | List budget rules (schedule or performance-based) for a campaign                                |
| List Campaign Negative Keywords  | List campaign-level negative keywords                                                           |
| List Campaigns                   |                                                                                                 |
| List Keywords                    | List keywords for Sponsored Products ad groups                                                  |
| List Negative Keywords           | List ad-group level negative keywords                                                           |
| List Negative Product Targets    | List negative product targets for an ad group                                                   |
| List Portfolios                  | List all portfolios for an Amazon Ads profile. Portfolios group campaigns for budget management |
| List Product Ads                 | List product ads (ASINs/SKUs) in an ad group                                                    |
| List Product Targets             | List product targets (ASIN/category targeting expressions) for an ad group                      |
| List Profiles                    |                                                                                                 |
| Run Health Check                 | Run a health check on all Amazon Ads profiles for this integration                              |
| Update Ad Group                  | Update an ad group (name, default bid, or state)                                                |
| Update Campaign                  | Update a Sponsored Products campaign (name, state, budget, dates, bidding)                      |
| Update Keyword                   | Update a keyword (bid or state)                                                                 |
| Update Portfolio                 | Update an existing portfolio (name, state, or budget)                                           |
| Update Product Ad                | Update a product ad (typically change state to paused/archived)                                 |
| Update Product Target            | Update a product target (bid or state)                                                          |
