Amazon Ads through One
Amazon Ads is an advertising platform that enables brands to promote their products across Amazon’s ecosystem, helping them reach shoppers through targeted ads, sponsored listings, and display campaigns.
One exposes Amazon Ads through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.
How to run an action
- Find the action in the table below, or call
search_one_platform_actions with platform amazon-ads if it is not listed.
- Call
get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
- Call
execute_one_action with parameters copied from that knowledge.
Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.
Before you start
Call list_one_integrations once and confirm Amazon Ads is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.
Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.
Before a write
Creates, updates, deletes and sends land on a real Amazon Ads account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.
Actions
Targets
| Action |
Method |
Path |
Action id |
| Create Targets |
POST |
/adsApi/v1/create/targets |
conn_mod_def::GJz4bC9HDZQ::wp0g1RjRSsqBO9LxKtJDWg |
| Create Targets (RAS v1) |
POST |
/ras/v1/targets |
conn_mod_def::GJz4cBNhFOU::QUe0GJ2LQSitncNzXJxIxg |
| Delete Targets (Bulk) |
POST |
/adsApi/v1/delete/targets |
conn_mod_def::GJz4bWBOWeg::8etlvFWiRYKG4yghqs6LwA |
| Delete Targets (RAS v1) |
POST |
/ras/v1/targets/delete |
conn_mod_def::GJz4cKBHvU4::_V_fv6yYQQyDgjcAXP7rJQ |
| List Targets (RAS v1) |
POST |
/ras/v1/targets/list |
conn_mod_def::GJz4cT6xjLs::YZCAgvxTT9OLLzcRH3Cj3Q |
| Query Targets |
POST |
/adsApi/v1/query/targets |
conn_mod_def::GJz4b4wRZ84::4_GUEE1CTZSt6aD0TQTKEw |
| Update Targets |
POST |
/adsApi/v1/update/targets |
conn_mod_def::GJz4csjzqMo::BXtU5CaoS0q51DG4oC2KTQ |
| Update Targets (RAS v1) |
PUT |
/ras/v1/targets |
conn_mod_def::GJz4cdRiR7E::1oy23pPYR4KjKOzA91mS6A |
AmcInstances
| Action |
Method |
Path |
Action id |
| Get an AMC Instance |
GET |
/amc/instances/{{instanceId}} |
conn_mod_def::GJz3ti1wZ04::IOK6Dj7xT1C59yDqxHaFkg |
| Get an AMC Instance’s Collaboration Metadata |
GET |
/amc/instances/{{instanceId}}/collaboration |
conn_mod_def::GJz3J7THgiY::755AD0ipQ7SlXVbTgmHidg |
| List AMC Instances |
GET |
/amc/instances |
conn_mod_def::GJz3tYnyyNY::pnphS0NAS0-s-MCfboAS8w |
| Create an AMC Instance |
POST |
/amc/instances |
conn_mod_def::GJz3s4_6B94::DcnrSfWrR_ifW_B-ejG10A |
| Delete an AMC Instance |
DELETE |
/amc/instances/{{instanceId}} |
conn_mod_def::GJz3tCLzN1s::2jrr9LwpSnS3MSmmGjaffQ |
| List a Collaboration’s ID Namespaces in an AMC Instance |
POST |
/amc/instances/{{instanceId}}/collaboration/idnamespaces/list |
conn_mod_def::GJz3KmLGOVU::rYxiZWAIRqiU99wcyeDmYg |
| Update an AMC Instance |
PUT |
/amc/instances/{{instanceId}} |
conn_mod_def::GJz3uUa_D0k::MyjtU-8YSvOenBq-2PTs3Q |
| Update an AMC Instance's Customer AWS Account Metadata |
POST |
/amc/instances/{{instanceId}}/updateCustomerAwsAccount |
conn_mod_def::GJz3uIYW9Og::YoroJYS9T_O2vRiW4i9usw |
SdAdGroups
| Action |
Method |
Path |
Action id |
| Get a Sponsored Display Ad Group |
GET |
/sd/adGroups/{{adGroupId}} |
conn_mod_def::GJz2lUJx2e0::NvFjKaV7S4ayjw-GHbu0TA |
| Get a Sponsored Display Ad Group’s Extended Information |
GET |
/sd/adGroups/extended/{{adGroupId}} |
conn_mod_def::GJz2leWTxPY::5JDxB2YQRXasc6E4zxiM0A |
| List Sponsored Display Ad Groups |
GET |
/sd/adGroups |
conn_mod_def::GJz2k__1LFA::jL2i_-faRfWARere9SzV6g |
| List Sponsored Display Ad Groups (Extended Fields) |
GET |
/sd/adGroups/extended |
conn_mod_def::GJz2lK9raRg::Kc9zNiG-TnaVa7qwb-oXvw |
| Archive a Sponsored Display Ad Group |
DELETE |
/sd/adGroups/{{adGroupId}} |
conn_mod_def::GJz2lnE8KMs::d5VznAO9RdS7foVfKS9NIQ |
| Create Sponsored Display Ad Groups |
POST |
/sd/adGroups |
conn_mod_def::GJz2kwNJAa4::fu-V7hjgRgmSUlu1OPL7Vg |
| Update Sponsored Display Ad Groups |
PUT |
/sd/adGroups |
conn_mod_def::GJz2lv-A_dE::ckm0LN2oQIGkTU4gxqprSA |
SdBudgetRules
| Action |
Method |
Path |
Action id |
| Get an SD Budget Rule by ID |
GET |
/sd/budgetRules/{{budgetRuleId}} |
conn_mod_def::GJz28EwTVEM::n4apPJvpQeeh734xgpAxyQ |
| Get an SD Budget Rule by ID |
GET |
/sd/budgetRules/{{budgetRuleId}} |
conn_mod_def::GJz2-cOxGCw::9N8VxvHaTkil2kgQC-gEmg |
| List an Advertiser’s Sponsored Display Budget Rules |
GET |
/sd/budgetRules |
conn_mod_def::GJz278ETmC8::05uvokBPRZWr32P-MbNd4w |
| List an Advertiser’s Sponsored Display Budget Rules |
GET |
/sd/budgetRules |
conn_mod_def::GJz2-R_OQXA::VkIQf-SiQ4ukq4IVuuVfkg |
| Create Sponsored Display (SD) Budget Rules |
POST |
/sd/budgetRules |
conn_mod_def::GJz27k3gmkE::bXWgOoBoRPOWb6hgTBD-Kg |
| Create Sponsored Display (SD) Budget Rules |
POST |
/sd/budgetRules |
conn_mod_def::GJz2999ljuE::_ji7Vje-Rf-Ko_lZq5vETw |
| Update Sponsored Display (SD) Budget Rules |
PUT |
/sd/budgetRules |
conn_mod_def::GJz2-4rW_5s::rxciN-STRTO393Hi9TblpQ |
SdNegativeTargets
| Action |
Method |
Path |
Action id |
| Get a Negative Targeting Clause’s Extended Information (Sponsored Display) |
GET |
/sd/negativeTargets/extended/{{negativeTargetId}} |
conn_mod_def::GJz39mdLA7k::eWUMTHS0TuuZyxOLKwiwpA |
| Get a Sponsored Display Negative Target by ID |
GET |
/sd/negativeTargets/{{negativeTargetId}} |
conn_mod_def::GJz39cy4N_I::nY_TeMh6RKGEeAHjSzvBVQ |
| List Sponsored Display Negative Targeting Clauses |
GET |
/sd/negativeTargets |
conn_mod_def::GJz39PbgM1A::7kL-D01PSXO9krGXEPXL3A |
| List Sponsored Display Negative Targeting Clauses (Extended Fields) |
GET |
/sd/negativeTargets/extended |
conn_mod_def::GJz39E9LsjQ::K8_hPHhdQ0mOl9Qyv1Btaw |
| Archive a Sponsored Display Negative Targeting Clause |
DELETE |
/sd/negativeTargets/{{negativeTargetId}} |
conn_mod_def::GJz39wV9clM::bx54j2ItRJWs_ZRB7i-L_Q |
| Create Sponsored Display Negative Targeting Clauses |
POST |
/sd/negativeTargets |
conn_mod_def::GJz386gXr48::eSPI0lhtRJeQsigRWGX3Qw |
| Update Sponsored Display Negative Targeting Clauses |
PUT |
/sd/negativeTargets |
conn_mod_def::GJz395V_Gi4::9_UoeoMgRl-Qx22SeiLTXw |
Posts
| Action |
Method |
Path |
Action id |
| Get a Post |
GET |
/bp/v2/posts/{{postId}} |
conn_mod_def::GJz4EAJ6_6c::_Hre9VmiTfK4nB8W77LTxQ |
| Create a Post |
POST |
/bp/v2/posts |
conn_mod_def::GJz4DfoAwHs::RNzw4sZTRZm-JJdpuM3utA |
| List Posts (with Performance Metrics) |
POST |
/bp/v2/posts/list |
conn_mod_def::GJz4Dswuerg::CFbUmQavTTa1MDX8kmnuxw |
| Submit a Post for Review |
PUT |
/bp/v2/posts/{{postId}}/submitForReview |
conn_mod_def::GJz4EvPsqEw::zJd289nmTBO8cgfdYmsS_g |
| Unpublish a Post (Withdraw a Post) |
PUT |
/bp/v2/posts/{{postId}}/unpublish |
conn_mod_def::GJz4E6OH10w::qCItTXvqS8KsQzrL7tRgaw |
| Update a Post’s Data |
PUT |
/bp/v2/posts/{{postId}} |
conn_mod_def::GJz4FDgXEy8::VhdotMB2RGSH39hq2sOD_g |
SdProductAds
| Action |
Method |
Path |
Action id |
| Get a Sponsored Display Product Ad |
GET |
/sd/productAds/{{adId}} |
conn_mod_def::GJz4Gbrc8ac::-3DBxi1aSiiLK8Jct9j3tw |
| Get Extended Information for a Sponsored Display Product Ad |
GET |
/sd/productAds/extended/{{adId}} |
conn_mod_def::GJz4GkP4ycA::7mPlHVElSDedIMAZ8P6zpA |
| List Sponsored Display Product Ads |
GET |
/sd/productAds |
conn_mod_def::GJz4GI01ZcQ::Y0DB1x2wTXKxe1sMizfbBw |
| Archive a Sponsored Display Product Ad |
DELETE |
/sd/productAds/{{adId}} |
conn_mod_def::GJz4Gs7O2r0::ZHElqEXaSF-BQ5wcOyyJ5g |
| Create Sponsored Display Product Ads |
POST |
/sd/productAds |
conn_mod_def::GJz4F81Utgs::kzzv5uuRSM-e9iYJdt8Yyg |
| Update Sponsored Display Product Ads (Batch) |
PUT |
/sd/productAds |
conn_mod_def::GJz4G21tJeA::Rs5mtpaCSNusoDwPpGj4Jg |
Reports
| Action |
Method |
Path |
Action id |
| Download a Report File (Redirect to S3) |
GET |
/v2/reports/{{reportId}}/download |
conn_mod_def::GJz4QYIpquU::jE4NN1oITp6arEJQsf-fmQ |
| Download a Sponsored Ads Report (Redirect to S3) |
GET |
/v2/reports/{{reportId}}/download |
conn_mod_def::GJz4QhhCTUc::wvpJQNFJRQy2NkFEt8o98w |
| Get a Report's Status |
GET |
/v2/reports/{{reportId}} |
conn_mod_def::GJz4RXU96pk::ZbwrXxYdSxWLiNbpemdmnQ |
| Get a Report’s Status |
GET |
/v2/reports/{{reportId}} |
conn_mod_def::GJz4Q8LNCVE::8OBO1V3tQvy3EH2dDlRLUQ |
| Create an Async Report Request |
POST |
/reporting/reports |
conn_mod_def::GJz2wTgY0Bs::4TOH6PBqQjyseV5F_gbNWg |
| Delete an Async Report by ID |
DELETE |
/reporting/reports/{{reportId}} |
conn_mod_def::GJz2wc5rmV0::OLrUAxBxTDu1fona-6TiEQ |
AdGroups
| Action |
Method |
Path |
Action id |
| Create Ad Groups |
POST |
/adsApi/v1/create/adGroups |
conn_mod_def::GJz2nGkLGiQ::pxzF3n7eTbmqrkUMHuIfmQ |
| Delete Ad Groups |
POST |
/adsApi/v1/delete/adGroups |
conn_mod_def::GJz2nZV4-TY::-WZub7D4Tou9vJWazSMUng |
| Delete Ad Groups (RAS v1) |
POST |
/ras/v1/adGroups/delete |
conn_mod_def::GJz2oNgjqIc::_OR6JSh8R-axCtGJl8aiBQ |
| Query Ad Groups |
POST |
/adsApi/v1/query/adGroups |
conn_mod_def::GJz2n5X1ARg::vTDZpXoKTyiIcoBZZ9YzFA |
| Update Ad Groups |
POST |
/adsApi/v1/update/adGroups |
conn_mod_def::GJz2orRh3q0::vTcD4gpeQxaZ98TR3tPCGA |
| Update Ad Groups (RAS v1) |
PUT |
/ras/v1/adGroups |
conn_mod_def::GJz2oh78DGI::BB-nHuKzSCqqZ_htoyXh1w |
SdCampaignBudgetRules
| Action |
Method |
Path |
Action id |
| List a Sponsored Display Campaign’s Associated Budget Rules |
GET |
/sd/campaigns/{{campaignId}}/budgetRules |
conn_mod_def::GJz28NnhVeE::H7LQ7fAEScC9J4zZdxm7LQ |
| List a Sponsored Display Campaign’s Associated Budget Rules |
GET |
/sd/campaigns/{{campaignId}}/budgetRules |
conn_mod_def::GJz2-lr6wpA::tm6B3A10STuCuViQwddKjg |
| Associate Budget Rules to an SD Campaign |
POST |
/sd/campaigns/{{campaignId}}/budgetRules |
conn_mod_def::GJz27b_5XI4::xyB3WVrvQWmqqbJQSLQWfQ |
| Associate Budget Rules to an SD Campaign |
POST |
/sd/campaigns/{{campaignId}}/budgetRules |
conn_mod_def::GJz29ySIB0A::at19vtPLSQCau0JUAI_l6g |
| Disassociate a Budget Rule from a Sponsored Display Campaign |
DELETE |
/sd/campaigns/{{campaignId}}/budgetRules/{{budgetRuleId}} |
conn_mod_def::GJz27yvk8Oc::rWq9AoDnQgiKb9mIFztyvA |
| Disassociate a Budget Rule from a Sponsored Display Campaign |
DELETE |
/sd/campaigns/{{campaignId}}/budgetRules/{{budgetRuleId}} |
conn_mod_def::GJz2-HEuFYI::1nHa10d6ThG_d1ZHTipY1g |
Campaigns
| Action |
Method |
Path |
Action id |
| Create Campaigns |
POST |
/adsApi/v1/create/campaigns |
conn_mod_def::GJz3Ebb2RNw::edRoVwuBQI6dL8RiPlMDpw |
| Create Campaigns (RAS v1) |
POST |
/ras/v1/campaigns |
conn_mod_def::GJz3G_DNe9w::izdd588vQAGNHVz3B-yq6w |
| Delete Campaigns |
POST |
/adsApi/v1/delete/campaigns |
conn_mod_def::GJz3FNZv2lk::CMt5UX1-QeS_1pSszGsM9A |
| Query Campaigns |
POST |
/adsApi/v1/query/campaigns |
conn_mod_def::GJz3G1307p4::HHwWcSGeRi6nJrQUGu4ITg |
| Update Campaigns (Bulk) |
POST |
/adsApi/v1/update/campaigns |
conn_mod_def::GJz3H6tz3nA::P3qIwbIcRNW8H0QtC3RMhw |
| Update Campaigns (RAS v1) |
PUT |
/ras/v1/campaigns |
conn_mod_def::GJz3HcHhgeM::RQa9rSbFS4G7pytYohyhww |
SdCampaigns
| Action |
Method |
Path |
Action id |
| Get a Sponsored Display Campaign |
GET |
/sd/campaigns/{{campaignId}} |
conn_mod_def::GJz3GCd0DjA::FX7cS8XmQp6GZOSRsw25YQ |
| Get a Sponsored Display Campaign’s Extended Information |
GET |
/sd/campaigns/extended/{{campaignId}} |
conn_mod_def::GJz3GLHGZYM::i0baPjpgRbuJz83GmGYs6w |
| List Sponsored Display Campaigns |
GET |
/sd/campaigns |
conn_mod_def::GJz3FvaQ7Rs::J4bWxUmcSEq4CFE9gsXHlA |
| List Sponsored Display Campaigns (Extended Fields) |
GET |
/sd/campaigns/extended |
conn_mod_def::GJz3F5zT_II::9fP0FpVaTH-vAOvtyJEKjQ |
| Create Sponsored Display Campaigns |
POST |
/sd/campaigns |
conn_mod_def::GJz3EkXTedc::yJNbC7QLTJO6WC1H64AHFQ |
| Update Sponsored Display Campaigns (Bulk) |
PUT |
/sd/campaigns |
conn_mod_def::GJz3IDlXgNA::F8KjRMwXR4iIZfksCGhB1g |
FrequencyGroups
| Action |
Method |
Path |
Action id |
| Get a Frequency Group (v1) |
GET |
/frequencyGroups/v1/{{frequencyGroupId}} |
conn_mod_def::GJz3knEXsoM::WyATLlrfQguV56PHaZc0Sg |
| Create a Frequency Group (v1) |
POST |
/frequencyGroups/v1 |
conn_mod_def::GJz3kbfpHBY::z1enHvLqSLqsLjw8VY4aig |
| List a DSP Advertiser’s Campaign/Frequency Group Associations |
POST |
/frequencyGroups/v1/campaigns/list |
conn_mod_def::GJz3lektvdw::kk9OxB6VRz2xDrukfv9E7w |
| List Advertisers’ Frequency Group Associations (v1) |
POST |
/frequencyGroups/v1/advertisers/list |
conn_mod_def::GJz3lUmL35Q::RrBAJoj-T4qmMGC7wkqUzQ |
| List Frequency Groups |
POST |
/frequencyGroups/v1/list |
conn_mod_def::GJz3kycBUM0::peM5pedhTYicPO6RjXiuQA |
| Update a Frequency Group |
PATCH |
/frequencyGroups/v1/{{frequencyGroupId}} |
conn_mod_def::GJz3k86JOKI::it1M15PuRke9TKx--9phqg |
PartnerOpportunities
| Action |
Method |
Path |
Action id |
| Get a Partner Opportunity Data File Redirect URL |
GET |
/partnerOpportunities/{{partnerOpportunityId}}/file |
conn_mod_def::GJz4BbgEHGw::D3FGLsCjR3ittOAjLtkmMg |
| List Partner Opportunities |
GET |
/partnerOpportunities |
conn_mod_def::GJz4BlBH0rc::C369sdtYQqODftOI9XENKA |
| Summarize a Partner’s Opportunities |
GET |
/partnerOpportunities/summary |
conn_mod_def::GJz4Bv3uGrY::tANX1TafQ_iSd5oUOZD4SA |
| Apply Recommendations for a Partner Opportunity |
POST |
/partnerOpportunities/{{partnerOpportunityId}}/apply |
conn_mod_def::GJz4BS6ZsyY::ohbWTDS6TOKHflYq4q6YFQ |
| Get a Partner Opportunity’s Application Status |
POST |
/partnerOpportunities/{{partnerOpportunityId}}/applicationStatus |
conn_mod_def::GJz4BKC3Uq0::PzX2GNWVT1GvhJPHAtTTuA |
This lists 90 of 792 actions. For anything not here, call search_one_platform_actions with platform amazon-ads. The full catalog is at https://www.withone.ai/knowledge/amazon-ads.
When a call fails
The error comes from Amazon Ads, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.
Full catalog: https://www.withone.ai/knowledge/amazon-ads
Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.
withoneai