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: OAuthDocumentation Index
Fetch the complete documentation index at: https://hyperfx.ai/docs/llms.txt
Use this file to discover all available pages before exploring further.
For how integrations work overall (permissions, authentication, troubleshooting), see the main guide: App Integrations.
Connect Amazon Ads
- Go to Settings → Apps in Hyper
- Select Amazon Ads → Connect New
- Authorize with Amazon Ads — grant access to the seller / vendor accounts you want Hyper to manage
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
- In a chat, open the tool selector and enable Amazon Ads
- Ask your agent to manage your campaigns
Use in Agents
InAgents → 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 |
| 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) |