Amazon Ads
The 78 tools Pilot MCP serves for Amazon Ads: 25 read-only, and 53 that write with the €29 plan, taken from the server.
Pilot MCP serves 25 read-only tools for Amazon Ads, on every plan. With the €29 plan, it also serves 36 that create or change and 17 that delete. Their names start with amazon_ads_.
What each entry shows
The name, description and parameters come from the list the server serves to your assistant (tools/list). Descriptions are in English: this is the text your assistant receives. Your assistant never fills in platform credentials: Pilot adds them on each call.
Writing and deleting
Write tools are only served with the €29 plan: your assistant creates, changes, pauses and deletes there, with no access level to pick when you connect. On the free plan, it does not see them. A change that sets an object to deleted or archived counts as a deletion, and a deletion targets one object at a time. Changes apply directly on the ad platform: Pilot reads the object from the platform before and after the write, and logs it in your workspace. See Read and write.
Tool families
| Family | Tools |
|---|---|
| Other tools | 25 |
| Create and change (€29) | 36 |
| Delete (€29) | 17 |
Other tools
amazon_ads_create_report
Amazon Ads: Create Report · read-only · creates an object on each call
Creates an async Amazon Ads report (POST /reporting/reports). Returns a reportId to poll afterwards with get_report. reportTypeId: spCampaigns / sbCampaigns / sdCampaigns. Requires a profile_id (= Amazon-Ads-AccountId).
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | no | Report name (optional). |
start_date | string | yes | Start date, YYYY-MM-DD. |
end_date | string | yes | End date, YYYY-MM-DD. |
ad_product | string | yes | Advertising program targeted. Values: "SPONSORED_PRODUCTS", "SPONSORED_BRANDS", "SPONSORED_DISPLAY". |
report_type_id | string | yes | Report type (must match ad_product). Values: "spCampaigns", "sbCampaigns", "sdCampaigns". |
group_by | string[] | no | Grouping dimensions, e.g. ['campaign']. Default: ["campaign"]. |
columns | string[] | yes | Columns/metrics, e.g. ['impressions','clicks','cost','campaignId','campaignName']. |
time_unit | string | no | Time granularity. Values: "SUMMARY", "DAILY". Default: "SUMMARY". |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_get_profile
Amazon Ads: Get Profile · read-only · idempotent
Returns one specific Amazon advertising profile (GET /v2/profiles/{profileId}).
| Parameter | Type | Required | Description |
|---|---|---|---|
profile_id | string | yes | ID of the Amazon Advertising profile. |
amazon_ads_get_report
Amazon Ads: Get Report · read-only · idempotent
Checks the status of an Amazon Ads report (GET /reporting/reports/{reportId}). If COMPLETED and download=true, downloads and decompresses (gunzip) the S3 file and returns the rows.
| Parameter | Type | Required | Description |
|---|---|---|---|
report_id | string | yes | Report ID (returned by create_report). |
download | boolean | no | If true and status=COMPLETED, downloads and gunzips the file and returns the rows. Default: false. |
max_rows | number | no | Maximum number of rows returned when download is set. Default: 1000. |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_list_profiles
Amazon Ads: List Profiles · read-only · idempotent
Lists the accessible Amazon advertising profiles (one profile = one marketplace/account). The returned profileId must be used as the scope for the other calls.
| Parameter | Type | Required | Description |
|---|---|---|---|
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_sb_list_ad_groups
Amazon Ads: SB List Ad Groups · read-only · idempotent
Lists Sponsored Brands ad groups (v4, POST /sb/v4/adGroups/list). Reads pages (nextToken) up to max_results items (default 100). If data.pagination.tronque is true, the list is NOT complete: call again with next_token = data.pagination.suite.
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_id_filter | string[] | no | |
state_filter | string[] | no | Values: "ENABLED", "PAUSED", "ARCHIVED". |
max_results | integer | no | Maximum number of items read, across all pages (default 100, at most 5000). Default: 100. |
next_token | string | no | Resumes a truncated list: the value of data.pagination.suite from the previous response. |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_sb_list_ads
Amazon Ads: SB List Ads · read-only · idempotent
Lists Sponsored Brands ads (v4, POST /sb/v4/ads/list). Reads pages (nextToken) up to max_results items (default 100). If data.pagination.tronque is true, the list is NOT complete: call again with next_token = data.pagination.suite.
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_id_filter | string[] | no | |
ad_group_id_filter | string[] | no | |
max_results | integer | no | Maximum number of items read, across all pages (default 100, at most 5000). Default: 100. |
next_token | string | no | Resumes a truncated list: the value of data.pagination.suite from the previous response. |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_sb_list_campaigns
Amazon Ads: SB List Campaigns · read-only · idempotent
Lists Sponsored Brands campaigns (v4, POST /sb/v4/campaigns/list). State in UPPERCASE. Reads pages (nextToken) up to max_results items (default 100). If data.pagination.tronque is true, the list is NOT complete: call again with next_token = data.pagination.suite.
| Parameter | Type | Required | Description |
|---|---|---|---|
state_filter | string[] | no | Values: "ENABLED", "PAUSED", "ARCHIVED". |
max_results | integer | no | Maximum number of items read, across all pages (default 100, at most 5000). Default: 100. |
next_token | string | no | Resumes a truncated list: the value of data.pagination.suite from the previous response. |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_sb_list_keywords
Amazon Ads: SB List Keywords · read-only · idempotent
Lists Sponsored Brands keywords (targeting v3, GET /sb/keywords). Reads pages (startIndex, count) up to count items (default 100). If data.pagination.tronque is true, the list is NOT complete: call again with start_index = data.pagination.suite.
| Parameter | Type | Required | Description |
|---|---|---|---|
start_index | integer | no | Starting position (0 = the first item). To resume a truncated list: data.pagination.suite. Default: 0. |
count | integer | no | Maximum number of items read, across all pages (default 100, at most 5000). The server reads in pages of 100. Default: 100. |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_sb_list_negative_keywords
Amazon Ads: SB List Negative Keywords · read-only · idempotent
Lists Sponsored Brands negative keywords (targeting v3, GET /sb/negativeKeywords), optionally filtered by campaign, ad group or negative keyword IDs. Reads pages (startIndex, count) up to count items (default 100). If data.pagination.tronque is true, the list is NOT complete: call again with start_index = data.pagination.suite.
| Parameter | Type | Required | Description |
|---|---|---|---|
start_index | integer | no | Starting position (0 = the first item). To resume a truncated list: data.pagination.suite. Default: 0. |
count | integer | no | Maximum number of items read, across all pages (default 100, at most 5000). The server reads in pages of 100. Default: 100. |
campaign_id_filter | string[] | no | Campaign IDs. |
ad_group_id_filter | string[] | no | Ad group IDs. |
keyword_id_filter | string[] | no | Negative keyword IDs. |
state_filter | string[] | no | Values: "enabled", "paused", "archived". |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_sb_list_targets
Amazon Ads: SB List Targets · read-only · idempotent
Lists Sponsored Brands targets (targeting v3, POST /sb/targets/list). Reads pages (nextToken) up to max_results items (default 100). If data.pagination.tronque is true, the list is NOT complete: call again with next_token = data.pagination.suite.
| Parameter | Type | Required | Description |
|---|---|---|---|
max_results | integer | no | Maximum number of items read, across all pages (default 100, at most 5000). Default: 100. |
next_token | string | no | Resumes a truncated list: the value of data.pagination.suite from the previous response. |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_sd_get_campaign
Amazon Ads: SD Get Campaign · read-only · idempotent
Returns one Sponsored Display campaign by its id (GET /sd/campaigns/{campaignId}).
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_id | string | yes | ID of the SD campaign. |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_sd_list_ad_groups
Amazon Ads: SD List Ad Groups · read-only · idempotent
Lists Sponsored Display ad groups (GET /sd/adGroups). Reads pages (startIndex, count) up to count items (default 100). If data.pagination.tronque is true, the list is NOT complete: call again with start_index = data.pagination.suite.
| Parameter | Type | Required | Description |
|---|---|---|---|
start_index | integer | no | Starting position (0 = the first item). To resume a truncated list: data.pagination.suite. Default: 0. |
count | integer | no | Maximum number of items read, across all pages (default 100, at most 5000). The server reads in pages of 100. Default: 100. |
state_filter | string[] | no | Values: "enabled", "paused", "archived". |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_sd_list_campaigns
Amazon Ads: SD List Campaigns · read-only · idempotent
Lists Sponsored Display campaigns (GET /sd/campaigns). State in LOWERCASE (enabled/paused/archived). Reads pages (startIndex, count) up to count items (default 100). If data.pagination.tronque is true, the list is NOT complete: call again with start_index = data.pagination.suite.
| Parameter | Type | Required | Description |
|---|---|---|---|
start_index | integer | no | Starting position (0 = the first item). To resume a truncated list: data.pagination.suite. Default: 0. |
count | integer | no | Maximum number of items read, across all pages (default 100, at most 5000). The server reads in pages of 100. Default: 100. |
state_filter | string[] | no | Filter by state (lowercase). Values: "enabled", "paused", "archived". |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_sd_list_creatives
Amazon Ads: SD List Creatives · read-only · idempotent
Lists Sponsored Display creatives (GET /sd/creatives). The API offers no delete. Reads pages (startIndex, count) up to count items (default 100). If data.pagination.tronque is true, the list is NOT complete: call again with start_index = data.pagination.suite.
| Parameter | Type | Required | Description |
|---|---|---|---|
start_index | integer | no | Starting position (0 = the first item). To resume a truncated list: data.pagination.suite. Default: 0. |
count | integer | no | Maximum number of items read, across all pages (default 100, at most 5000). The server reads in pages of 100. Default: 100. |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_sd_list_negative_targets
Amazon Ads: SD List Negative Targets · read-only · idempotent
Lists Sponsored Display negative targets (GET /sd/negativeTargets), optionally filtered by campaign or ad group IDs. Reads pages (startIndex, count) up to count items (default 100). If data.pagination.tronque is true, the list is NOT complete: call again with start_index = data.pagination.suite.
| Parameter | Type | Required | Description |
|---|---|---|---|
start_index | integer | no | Starting position (0 = the first item). To resume a truncated list: data.pagination.suite. Default: 0. |
count | integer | no | Maximum number of items read, across all pages (default 100, at most 5000). The server reads in pages of 100. Default: 100. |
campaign_id_filter | string[] | no | Campaign IDs. |
ad_group_id_filter | string[] | no | Ad group IDs. |
state_filter | string[] | no | Values: "enabled", "paused", "archived". |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_sd_list_product_ads
Amazon Ads: SD List Product Ads · read-only · idempotent
Lists Sponsored Display product ads (GET /sd/productAds). Reads pages (startIndex, count) up to count items (default 100). If data.pagination.tronque is true, the list is NOT complete: call again with start_index = data.pagination.suite.
| Parameter | Type | Required | Description |
|---|---|---|---|
start_index | integer | no | Starting position (0 = the first item). To resume a truncated list: data.pagination.suite. Default: 0. |
count | integer | no | Maximum number of items read, across all pages (default 100, at most 5000). The server reads in pages of 100. Default: 100. |
state_filter | string[] | no | Values: "enabled", "paused", "archived". |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_sd_list_targets
Amazon Ads: SD List Targets · read-only · idempotent
Lists Sponsored Display targets (GET /sd/targets). Reads pages (startIndex, count) up to count items (default 100). If data.pagination.tronque is true, the list is NOT complete: call again with start_index = data.pagination.suite.
| Parameter | Type | Required | Description |
|---|---|---|---|
start_index | integer | no | Starting position (0 = the first item). To resume a truncated list: data.pagination.suite. Default: 0. |
count | integer | no | Maximum number of items read, across all pages (default 100, at most 5000). The server reads in pages of 100. Default: 100. |
state_filter | string[] | no | Values: "enabled", "paused", "archived". |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_sp_list_ad_groups
Amazon Ads: SP List Ad Groups · read-only · idempotent
Lists Sponsored Products ad groups (POST /sp/adGroups/list). Reads pages (nextToken) up to max_results items (default 100). If data.pagination.tronque is true, the list is NOT complete: call again with next_token = data.pagination.suite.
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_id_filter | string[] | no | Filter by campaignId. |
state_filter | string[] | no | Filter by state. Values: "ENABLED", "PAUSED", "ARCHIVED". |
max_results | integer | no | Maximum number of items read, across all pages (default 100, at most 5000). Default: 100. |
next_token | string | no | Resumes a truncated list: the value of data.pagination.suite from the previous response. |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_sp_list_budget_rules
Amazon Ads: SP List Budget Rules · read-only · idempotent
Lists Sponsored Products budget rules (GET /sp/budgetRules, pages of 30). Reads pages (nextToken) up to max_results items (default 100). If data.pagination.tronque is true, the list is NOT complete: call again with next_token = data.pagination.suite.
| Parameter | Type | Required | Description |
|---|---|---|---|
max_results | integer | no | Maximum number of items read, across all pages (default 100, at most 5000). Default: 100. |
next_token | string | no | Resumes a truncated list: the value of data.pagination.suite from the previous response. |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_sp_list_campaigns
Amazon Ads: SP List Campaigns · read-only · idempotent
Lists Sponsored Products campaigns (SP v3). POST /sp/campaigns/list. State in UPPERCASE. Reads pages (nextToken) up to max_results items (default 100). If data.pagination.tronque is true, the list is NOT complete: call again with next_token = data.pagination.suite.
| Parameter | Type | Required | Description |
|---|---|---|---|
state_filter | string[] | no | Filter by state (UPPERCASE). Values: "ENABLED", "PAUSED", "ARCHIVED". |
max_results | integer | no | Maximum number of items read, across all pages (default 100, at most 5000). Default: 100. |
next_token | string | no | Resumes a truncated list: the value of data.pagination.suite from the previous response. |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_sp_list_keywords
Amazon Ads: SP List Keywords · read-only · idempotent
Lists Sponsored Products keywords (POST /sp/keywords/list). Reads pages (nextToken) up to max_results items (default 100). If data.pagination.tronque is true, the list is NOT complete: call again with next_token = data.pagination.suite.
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_group_id_filter | string[] | no | |
state_filter | string[] | no | Values: "ENABLED", "PAUSED", "ARCHIVED". |
max_results | integer | no | Maximum number of items read, across all pages (default 100, at most 5000). Default: 100. |
next_token | string | no | Resumes a truncated list: the value of data.pagination.suite from the previous response. |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_sp_list_negative_keywords
Amazon Ads: SP List Negative Keywords · read-only · idempotent
Lists Sponsored Products negative keywords (POST /sp/negativeKeywords/list), optionally filtered by campaign, ad group or negative keyword IDs. Reads pages (nextToken) up to max_results items (default 100). If data.pagination.tronque is true, the list is NOT complete: call again with next_token = data.pagination.suite.
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_id_filter | string[] | no | |
ad_group_id_filter | string[] | no | |
negative_keyword_id_filter | string[] | no | |
state_filter | string[] | no | Values: "ENABLED", "PAUSED", "ARCHIVED". |
max_results | integer | no | Maximum number of items read, across all pages (default 100, at most 5000). Default: 100. |
next_token | string | no | Resumes a truncated list: the value of data.pagination.suite from the previous response. |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_sp_list_product_ads
Amazon Ads: SP List Product Ads · read-only · idempotent
Lists Sponsored Products product ads (POST /sp/productAds/list). Reads pages (nextToken) up to max_results items (default 100). If data.pagination.tronque is true, the list is NOT complete: call again with next_token = data.pagination.suite.
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_group_id_filter | string[] | no | Filter by adGroupId. |
state_filter | string[] | no | Values: "ENABLED", "PAUSED", "ARCHIVED". |
max_results | integer | no | Maximum number of items read, across all pages (default 100, at most 5000). Default: 100. |
next_token | string | no | Resumes a truncated list: the value of data.pagination.suite from the previous response. |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_sp_list_targets
Amazon Ads: SP List Targets · read-only · idempotent
Lists Sponsored Products targeting clauses (POST /sp/targets/list). Reads pages (nextToken) up to max_results items (default 100). If data.pagination.tronque is true, the list is NOT complete: call again with next_token = data.pagination.suite.
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_group_id_filter | string[] | no | |
state_filter | string[] | no | Values: "ENABLED", "PAUSED", "ARCHIVED". |
max_results | integer | no | Maximum number of items read, across all pages (default 100, at most 5000). Default: 100. |
next_token | string | no | Resumes a truncated list: the value of data.pagination.suite from the previous response. |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
amazon_ads_validate_operation
Amazon Ads: Validate Operation · read-only · idempotent
Validates an Amazon Ads operation on the client side (the API has no native validate and no sandbox): required fields present, correct state casing (SP/SB=UPPERCASE, SD=lowercase). Use it BEFORE a create/update to avoid an API error.
| Parameter | Type | Required | Description |
|---|---|---|---|
entity | string | yes | Entity prefixed by program (e.g. sp_campaign, sd_target). Values: "sp_campaign", "sp_adGroup", "sp_productAd", "sp_keyword", "sp_target", "sb_campaign", "sb_adGroup", "sb_keyword", "sb_target", "sd_campaign", "sd_adGroup", "sd_productAd", "sd_target", "sd_creative". |
operation | string | yes | Operation to validate. Values: "create", "update". |
payload | object | yes | Operation body (camelCase API keys: name, campaignId, state, matchType...). |
account_id | string | no | Amazon Ads account to use when the workspace has several, as returned by the account listing tool. Default: the first account linked to the workspace. |
Create and change (€29)
Served with the €29 plan.
amazon_ads_sb_create_ad
Amazon Ads: SB Create Ad · create or change, €29 plan · creates an object on each call
Creates Sponsored Brands ads (POST /sb/v4/ads/{ad_format}, batch). ad_format: productCollection, productCollectionExtended, storeSpotlight, video, brandVideo, autoCollection or manualCollection. Each object: adGroupId, name, creative (fields of the format), landingPage (required by productCollection, productCollectionExtended, storeSpotlight and brandVideo), state (PAUSED by default). Delete with sb_delete_ad. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again).
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_format | string | yes | Values: "productCollection", "productCollectionExtended", "storeSpotlight", "video", "brandVideo", "autoCollection", "manualCollection". |
ads | object[] | yes | Array of ad objects of the chosen format. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sb_create_ad_group
Amazon Ads: SB Create Ad Group · create or change, €29 plan · creates an object on each call
Creates Sponsored Brands ad groups (v4 batch, POST /sb/v4/adGroups). Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again).
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_groups | object[] | yes | Array of SB v4 ad group objects (name, campaignId, state). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sb_create_campaign
Amazon Ads: SB Create Campaign · create or change, €29 plan · creates an object on each call
Creates Sponsored Brands campaigns (v4 batch, POST /sb/v4/campaigns). Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again).
| Parameter | Type | Required | Description |
|---|---|---|---|
campaigns | object[] | yes | Array of SB v4 campaign objects (name, budgetType, budget, state, startDate...). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sb_create_keyword
Amazon Ads: SB Create Keyword · create or change, €29 plan · creates an object on each call
Creates Sponsored Brands keywords (targeting v3, POST /sb/keywords). Body = array of keyword objects. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). IDs (campaignId, adGroupId...): pass them as TEXT, as the lists return them; the server writes them as JSON integers, without rounding.
| Parameter | Type | Required | Description |
|---|---|---|---|
keywords | object[] | yes | Array of keyword objects (campaignId, adGroupId, keywordText, matchType, bid, state). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sb_create_negative_keyword
Amazon Ads: SB Create Negative Keyword · create or change, €29 plan · creates an object on each call
Creates Sponsored Brands negative keywords (targeting v3, POST /sb/negativeKeywords). Body = array of objects (campaignId, adGroupId, keywordText, matchType negativeExact or negativePhrase). List them with sb_list_negative_keywords, archive one with sb_delete_negative_keyword. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). IDs (campaignId, adGroupId...): pass them as TEXT, as the lists return them; the server writes them as JSON integers, without rounding.
| Parameter | Type | Required | Description |
|---|---|---|---|
negative_keywords | object[] | yes | Array of negative keyword objects (campaignId, adGroupId, keywordText, matchType). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sb_create_target
Amazon Ads: SB Create Target · create or change, €29 plan · creates an object on each call
Creates Sponsored Brands targets (targeting v3, POST /sb/targets). Body = array of target objects. Amazon answers HTTP 200 even when it rejects targets: the rejections are read from createTargetErrorResults. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). IDs (campaignId, adGroupId...): pass them as TEXT, as the lists return them; the server writes them as JSON integers, without rounding.
| Parameter | Type | Required | Description |
|---|---|---|---|
targets | object[] | yes | Array of target objects (campaignId, adGroupId, expression[], bid, state). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sb_update_ad
Amazon Ads: SB Update Ad · create or change, €29 plan · creates an object on each call
Updates Sponsored Brands ads (v4 batch, PUT /sb/v4/ads). Each object requires adId. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). An accepted update is followed by a read-back: data.after_update holds the objects read right after the write (if they still show the old value, Amazon may not have propagated it yet: read again a little later).
| Parameter | Type | Required | Description |
|---|---|---|---|
ads | object[] | yes | Array of ad objects with adId + fields to change (state...). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sb_update_ad_group
Amazon Ads: SB Update Ad Group · create or change, €29 plan · creates an object on each call
Renames, pauses or re-enables Sponsored Brands ad groups (PUT /sb/v4/adGroups, batch): each object { adGroupId, name?, state ENABLED or PAUSED }. To archive (delete) an ad group, use sb_delete_ad_group (admin only). Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). An accepted update is followed by a read-back: data.after_update holds the objects read right after the write (if they still show the old value, Amazon may not have propagated it yet: read again a little later).
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_groups | object[] | yes | Array of { adGroupId, name?, state? }. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sb_update_campaign
Amazon Ads: SB Update Campaign · create or change, €29 plan · creates an object on each call
Updates Sponsored Brands campaigns (v4 batch, PUT /sb/v4/campaigns). Each object requires campaignId. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). An accepted update is followed by a read-back: data.after_update holds the objects read right after the write (if they still show the old value, Amazon may not have propagated it yet: read again a little later).
| Parameter | Type | Required | Description |
|---|---|---|---|
campaigns | object[] | yes | Array of campaign objects with campaignId + fields to change (state, budget, name). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sb_update_keyword
Amazon Ads: SB Update Keyword · create or change, €29 plan · creates an object on each call
Updates Sponsored Brands keywords (targeting v3, PUT /sb/keywords). Body = array with keywordId. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). An accepted update is followed by a read-back: data.after_update holds the objects read right after the write (if they still show the old value, Amazon may not have propagated it yet: read again a little later). IDs (campaignId, adGroupId...): pass them as TEXT, as the lists return them; the server writes them as JSON integers, without rounding.
| Parameter | Type | Required | Description |
|---|---|---|---|
keywords | object[] | yes | Array of keyword objects with keywordId + fields (bid, state). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sb_update_target
Amazon Ads: SB Update Target · create or change, €29 plan · creates an object on each call
Updates Sponsored Brands targets (targeting v3, PUT /sb/targets). Body = array of objects with targetId, adGroupId and campaignId, and the changed fields (bid, state). A target's expression does not change. Amazon answers HTTP 200 even when it rejects targets: the rejections are read from updateTargetErrorResults. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). An accepted update is followed by a read-back: data.after_update holds the objects read right after the write (if they still show the old value, Amazon may not have propagated it yet: read again a little later). IDs (campaignId, adGroupId...): pass them as TEXT, as the lists return them; the server writes them as JSON integers, without rounding.
| Parameter | Type | Required | Description |
|---|---|---|---|
targets | object[] | yes | Array of target objects with targetId, adGroupId, campaignId + fields (bid, state). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sd_create_ad_group
Amazon Ads: SD Create Ad Group · create or change, €29 plan · creates an object on each call
Creates Sponsored Display ad groups (POST /sd/adGroups, body = array). Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). IDs (campaignId, adGroupId...): pass them as TEXT, as the lists return them; the server writes them as JSON integers, without rounding.
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_groups | object[] | yes | Array of SD ad group objects (name, campaignId, defaultBid, state). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sd_create_campaign
Amazon Ads: SD Create Campaign · create or change, €29 plan · creates an object on each call
Creates Sponsored Display campaigns (POST /sd/campaigns, body = array). State in lowercase. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). IDs (campaignId, adGroupId...): pass them as TEXT, as the lists return them; the server writes them as JSON integers, without rounding.
| Parameter | Type | Required | Description |
|---|---|---|---|
campaigns | object[] | yes | Array of SD campaign objects (name, budget, budgetType, state, tactic, startDate...). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sd_create_creative
Amazon Ads: SD Create Creative · create or change, €29 plan · creates an object on each call
Creates Sponsored Display creatives (POST /sd/creatives, body = array). They cannot be deleted afterwards. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). IDs (campaignId, adGroupId...): pass them as TEXT, as the lists return them; the server writes them as JSON integers, without rounding.
| Parameter | Type | Required | Description |
|---|---|---|---|
creatives | object[] | yes | Array of creative objects (adGroupId, name, type, properties...). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sd_create_negative_target
Amazon Ads: SD Create Negative Target · create or change, €29 plan · creates an object on each call
Creates Sponsored Display negative targets (POST /sd/negativeTargets, body = array): products or brands excluded from an ad group. Each object: adGroupId, state, expressionType "manual", expression [{ type: "asinSameAs" | "asinBrandSameAs", value }]. List them with sd_list_negative_targets, archive one with sd_delete_negative_target. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). IDs (campaignId, adGroupId...): pass them as TEXT, as the lists return them; the server writes them as JSON integers, without rounding.
| Parameter | Type | Required | Description |
|---|---|---|---|
negative_targets | object[] | yes | Array of negative target objects (adGroupId, state, expressionType, expression[]). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sd_create_product_ad
Amazon Ads: SD Create Product Ad · create or change, €29 plan · creates an object on each call
Creates Sponsored Display product ads (POST /sd/productAds, body = array). asin OR sku. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). IDs (campaignId, adGroupId...): pass them as TEXT, as the lists return them; the server writes them as JSON integers, without rounding.
| Parameter | Type | Required | Description |
|---|---|---|---|
product_ads | object[] | yes | Array of product ad objects (campaignId, adGroupId, asin OR sku, state). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sd_create_target
Amazon Ads: SD Create Target · create or change, €29 plan · creates an object on each call
Creates Sponsored Display targets (POST /sd/targets, body = array). Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). IDs (campaignId, adGroupId...): pass them as TEXT, as the lists return them; the server writes them as JSON integers, without rounding.
| Parameter | Type | Required | Description |
|---|---|---|---|
targets | object[] | yes | Array of target objects (campaignId, adGroupId, expression[], bid, state). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sd_update_ad_group
Amazon Ads: SD Update Ad Group · create or change, €29 plan · creates an object on each call
Updates Sponsored Display ad groups (PUT /sd/adGroups, body = array with adGroupId). Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). An accepted update is followed by a read-back: data.after_update holds the objects read right after the write (if they still show the old value, Amazon may not have propagated it yet: read again a little later). IDs (campaignId, adGroupId...): pass them as TEXT, as the lists return them; the server writes them as JSON integers, without rounding.
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_groups | object[] | yes | Array of ad group objects with adGroupId + fields (state, defaultBid, name). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sd_update_campaign
Amazon Ads: SD Update Campaign · create or change, €29 plan · creates an object on each call
Updates Sponsored Display campaigns (PUT /sd/campaigns, body = array with campaignId). Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). An accepted update is followed by a read-back: data.after_update holds the objects read right after the write (if they still show the old value, Amazon may not have propagated it yet: read again a little later). IDs (campaignId, adGroupId...): pass them as TEXT, as the lists return them; the server writes them as JSON integers, without rounding.
| Parameter | Type | Required | Description |
|---|---|---|---|
campaigns | object[] | yes | Array of campaign objects with campaignId + fields (state, budget, name). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sd_update_creative
Amazon Ads: SD Update Creative · create or change, €29 plan · creates an object on each call
Updates Sponsored Display creatives (PUT /sd/creatives, body = array of { creativeId, properties }). Amazon offers no delete for a creative. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). An accepted update is followed by a read-back: data.after_update holds the objects read right after the write (if they still show the old value, Amazon may not have propagated it yet: read again a little later). IDs (campaignId, adGroupId...): pass them as TEXT, as the lists return them; the server writes them as JSON integers, without rounding.
| Parameter | Type | Required | Description |
|---|---|---|---|
creatives | object[] | yes | Array of { creativeId, properties } (headline, brandLogo, video... depending on the creative type). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sd_update_product_ad
Amazon Ads: SD Update Product Ad · create or change, €29 plan · creates an object on each call
Updates the state of Sponsored Display product ads (PUT /sd/productAds, body = array of { adId, state enabled or paused }). To archive (delete) an ad, use sd_delete_product_ad (admin only). Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). An accepted update is followed by a read-back: data.after_update holds the objects read right after the write (if they still show the old value, Amazon may not have propagated it yet: read again a little later). IDs (campaignId, adGroupId...): pass them as TEXT, as the lists return them; the server writes them as JSON integers, without rounding.
| Parameter | Type | Required | Description |
|---|---|---|---|
product_ads | object[] | yes | Array of { adId, state }. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sd_update_target
Amazon Ads: SD Update Target · create or change, €29 plan · creates an object on each call
Updates Sponsored Display targets (PUT /sd/targets, body = array with targetId). Only bid and state (enabled, paused, archived) can be changed; a target's expression does not change. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). An accepted update is followed by a read-back: data.after_update holds the objects read right after the write (if they still show the old value, Amazon may not have propagated it yet: read again a little later). IDs (campaignId, adGroupId...): pass them as TEXT, as the lists return them; the server writes them as JSON integers, without rounding.
| Parameter | Type | Required | Description |
|---|---|---|---|
targets | object[] | yes | Array of target objects with targetId + fields (bid, state). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sp_create_ad_group
Amazon Ads: SP Create Ad Group · create or change, €29 plan · creates an object on each call
Creates one or more Sponsored Products ad groups (POST /sp/adGroups, batch). Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again).
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_groups | object[] | yes | Array of ad group objects (name, campaignId, defaultBid, state). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sp_create_budget_rule
Amazon Ads: SP Create Budget Rule · create or change, €29 plan · creates an object on each call
Creates one or more Sponsored Products budget rules (POST /sp/budgetRules). Amazon offers no delete for a budget rule: it can only be detached from a campaign. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again).
| Parameter | Type | Required | Description |
|---|---|---|---|
budget_rules_details | object[] | yes | Array of budgetRuleDetails objects (name, recurrence, budgetIncreaseBy...). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sp_create_campaign
Amazon Ads: SP Create Campaign · create or change, €29 plan · creates an object on each call
Creates one or more Sponsored Products campaigns (SP v3 batch, POST /sp/campaigns). Bulk operation: use confirm to execute (dry_run simulates). Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again).
| Parameter | Type | Required | Description |
|---|---|---|---|
campaigns | object[] | yes | Array of campaign objects (API keys: name, targetingType, state, budget{budget,budgetType}, startDate...). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sp_create_keyword
Amazon Ads: SP Create Keyword · create or change, €29 plan · creates an object on each call
Creates Sponsored Products keywords (POST /sp/keywords, batch). keywordText + matchType required. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again).
| Parameter | Type | Required | Description |
|---|---|---|---|
keywords | object[] | yes | Array of keyword objects (campaignId, adGroupId, keywordText, matchType EXACT/PHRASE/BROAD, bid, state). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sp_create_negative_keyword
Amazon Ads: SP Create Negative Keyword · create or change, €29 plan · creates an object on each call
Creates Sponsored Products negative keywords (POST /sp/negativeKeywords, batch). matchType NEGATIVE_EXACT/NEGATIVE_PHRASE. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again).
| Parameter | Type | Required | Description |
|---|---|---|---|
negative_keywords | object[] | yes | Array of negative keyword objects (campaignId, adGroupId, keywordText, matchType, state). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sp_create_product_ad
Amazon Ads: SP Create Product Ad · create or change, €29 plan · creates an object on each call
Creates Sponsored Products product ads (POST /sp/productAds, batch). asin OR sku required. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again).
| Parameter | Type | Required | Description |
|---|---|---|---|
product_ads | object[] | yes | Array of product ad objects (campaignId, adGroupId, asin OR sku, state). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sp_create_target
Amazon Ads: SP Create Target · create or change, €29 plan · creates an object on each call
Creates Sponsored Products targeting clauses (POST /sp/targets, batch). Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again).
| Parameter | Type | Required | Description |
|---|---|---|---|
targeting_clauses | object[] | yes | Array of targeting clause objects (campaignId, adGroupId, expression[], bid, state). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sp_update_ad_group
Amazon Ads: SP Update Ad Group · create or change, €29 plan · creates an object on each call
Updates Sponsored Products ad groups (PUT /sp/adGroups, batch). Each object requires adGroupId. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). An accepted update is followed by a read-back: data.after_update holds the objects read right after the write (if they still show the old value, Amazon may not have propagated it yet: read again a little later).
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_groups | object[] | yes | Array of ad group objects with adGroupId + fields to change. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sp_update_budget_rule
Amazon Ads: SP Update Budget Rule · create or change, €29 plan · creates an object on each call
Updates Sponsored Products budget rules (PUT /sp/budgetRules): each object { ruleId, ruleDetails?, ruleState? ACTIVE or PAUSED }. A budget rule can RAISE the daily budget of the campaigns it is attached to (budgetIncreaseBy, in percent, on a schedule or a performance condition): it puts more money at stake. ruleDetails accepts only the documented fields (name, ruleType, duration, recurrence, budgetIncreaseBy, performanceMeasureCondition). Amazon offers no delete for a budget rule; pause it with ruleState PAUSED. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). An accepted update is followed by a read-back: data.after_update holds the objects read right after the write (if they still show the old value, Amazon may not have propagated it yet: read again a little later).
| Parameter | Type | Required | Description |
|---|---|---|---|
budget_rules_details | object[] | yes | Array of { ruleId, ruleDetails?, ruleState? }. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sp_update_campaign
Amazon Ads: SP Update Campaign · create or change, €29 plan · creates an object on each call
Updates one or more Sponsored Products campaigns (SP v3 batch, PUT /sp/campaigns). Each object MUST contain campaignId. Bulk operation. To change the budget: budget = { budget: <amount>, budgetType: "DAILY" }. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). An accepted update is followed by a read-back: data.after_update holds the objects read right after the write (if they still show the old value, Amazon may not have propagated it yet: read again a little later).
| Parameter | Type | Required | Description |
|---|---|---|---|
campaigns | object[] | yes | Array of campaign objects with campaignId + fields to change (state, budget, name...). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sp_update_keyword
Amazon Ads: SP Update Keyword · create or change, €29 plan · creates an object on each call
Updates Sponsored Products keywords (PUT /sp/keywords, batch). Each object requires keywordId. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). An accepted update is followed by a read-back: data.after_update holds the objects read right after the write (if they still show the old value, Amazon may not have propagated it yet: read again a little later).
| Parameter | Type | Required | Description |
|---|---|---|---|
keywords | object[] | yes | Array of keyword objects with keywordId + fields (bid, state). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sp_update_negative_keyword
Amazon Ads: SP Update Negative Keyword · create or change, €29 plan · creates an object on each call
Pauses or re-enables Sponsored Products negative keywords (PUT /sp/negativeKeywords, batch): each object { keywordId, state ENABLED or PAUSED }. To archive (delete) one, use sp_delete_negative_keyword (admin only). Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). An accepted update is followed by a read-back: data.after_update holds the objects read right after the write (if they still show the old value, Amazon may not have propagated it yet: read again a little later).
| Parameter | Type | Required | Description |
|---|---|---|---|
negative_keywords | object[] | yes | Array of { keywordId, state }. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sp_update_product_ad
Amazon Ads: SP Update Product Ad · create or change, €29 plan · creates an object on each call
Updates the state of Sponsored Products product ads (PUT /sp/productAds, batch): each object { adId, state ENABLED or PAUSED }. The state is the only field Amazon lets change. To archive (delete) an ad, use sp_delete_product_ad (admin only). Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). An accepted update is followed by a read-back: data.after_update holds the objects read right after the write (if they still show the old value, Amazon may not have propagated it yet: read again a little later).
| Parameter | Type | Required | Description |
|---|---|---|---|
product_ads | object[] | yes | Array of { adId, state }. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sp_update_target
Amazon Ads: SP Update Target · create or change, €29 plan · creates an object on each call
Updates Sponsored Products targeting clauses (PUT /sp/targets, batch). Each object requires targetId; only bid and state can be changed, a target's expression does not change (create another one). Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again). An accepted update is followed by a read-back: data.after_update holds the objects read right after the write (if they still show the old value, Amazon may not have propagated it yet: read again a little later).
| Parameter | Type | Required | Description |
|---|---|---|---|
targeting_clauses | object[] | yes | Array of targeting clause objects with targetId + fields (bid, state). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
Delete (€29)
Served with the €29 plan. A deletion targets one object at a time.
amazon_ads_sb_delete_ad
Amazon Ads: SB Delete Ad · delete, €29 plan, one object at a time · creates an object on each call
ARCHIVES Sponsored Brands ads (v4, POST /sb/v4/ads/delete). IRREVERSIBLE. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again).
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_ids | string[] | yes | IDs of the ads. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sb_delete_ad_group
Amazon Ads: SB Delete Ad Group · delete, €29 plan, one object at a time · creates an object on each call
ARCHIVES Sponsored Brands ad groups (v4, POST /sb/v4/adGroups/delete). IRREVERSIBLE. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again).
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_group_ids | string[] | yes | IDs of the ad groups. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sb_delete_campaign
Amazon Ads: SB Delete Campaign · delete, €29 plan, one object at a time · creates an object on each call
ARCHIVES Sponsored Brands campaigns (v4, POST /sb/v4/campaigns/delete). IRREVERSIBLE. dry_run=true by default. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again).
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_ids | string[] | yes | IDs of the campaigns. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sb_delete_keyword
Amazon Ads: SB Delete Keyword · delete, €29 plan, one object at a time · creates an object on each call
ARCHIVES one Sponsored Brands keyword (targeting v3, DELETE /sb/keywords/{keywordId}). DELETE = archive. dry_run=true by default.
| Parameter | Type | Required | Description |
|---|---|---|---|
keyword_id | string | yes | ID of the keyword to archive. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sb_delete_negative_keyword
Amazon Ads: SB Delete Negative Keyword · delete, €29 plan, one object at a time · creates an object on each call
ARCHIVES one Sponsored Brands negative keyword (targeting v3, DELETE /sb/negativeKeywords/{keywordId}). DELETE = archive, permanent. dry_run=true by default.
| Parameter | Type | Required | Description |
|---|---|---|---|
keyword_id | string | yes | ID of the negative keyword to archive. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sb_delete_target
Amazon Ads: SB Delete Target · delete, €29 plan, one object at a time · creates an object on each call
ARCHIVES one Sponsored Brands target (targeting v3, DELETE /sb/targets/{targetId}). DELETE = archive. dry_run=true by default.
| Parameter | Type | Required | Description |
|---|---|---|---|
target_id | string | yes | ID of the target to archive. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sd_delete_ad_group
Amazon Ads: SD Delete Ad Group · delete, €29 plan, one object at a time · creates an object on each call
ARCHIVES one Sponsored Display ad group (DELETE /sd/adGroups/{adGroupId}). DELETE = archive. dry_run=true by default.
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_group_id | string | yes | ID of the ad group to archive. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sd_delete_campaign
Amazon Ads: SD Delete Campaign · delete, €29 plan, one object at a time · creates an object on each call
ARCHIVES one Sponsored Display campaign (DELETE /sd/campaigns/{campaignId}). DELETE = archive. dry_run=true by default.
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_id | string | yes | ID of the campaign to archive. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sd_delete_negative_target
Amazon Ads: SD Delete Negative Target · delete, €29 plan, one object at a time · creates an object on each call
ARCHIVES one Sponsored Display negative target (DELETE /sd/negativeTargets/{negativeTargetId}). DELETE = archive, permanent. dry_run=true by default.
| Parameter | Type | Required | Description |
|---|---|---|---|
negative_target_id | string | yes | ID of the negative target to archive. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sd_delete_product_ad
Amazon Ads: SD Delete Product Ad · delete, €29 plan, one object at a time · creates an object on each call
ARCHIVES one Sponsored Display product ad (DELETE /sd/productAds/{adId}). DELETE = archive. dry_run=true by default.
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_id | string | yes | ID of the product ad to archive. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sd_delete_target
Amazon Ads: SD Delete Target · delete, €29 plan, one object at a time · creates an object on each call
ARCHIVES one Sponsored Display target (DELETE /sd/targets/{targetId}). DELETE = archive. dry_run=true by default.
| Parameter | Type | Required | Description |
|---|---|---|---|
target_id | string | yes | ID of the target to archive. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sp_delete_ad_group
Amazon Ads: SP Delete Ad Group · delete, €29 plan, one object at a time · creates an object on each call
ARCHIVES Sponsored Products ad groups (POST /sp/adGroups/delete). IRREVERSIBLE. dry_run=true by default. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again).
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_group_ids | string[] | yes | IDs of the ad groups. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sp_delete_campaign
Amazon Ads: SP Delete Campaign · delete, €29 plan, one object at a time · creates an object on each call
Permanently ARCHIVES Sponsored Products campaigns (POST /sp/campaigns/delete). IRREVERSIBLE on Amazon's side. dry_run=true by default. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again).
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_ids | string[] | yes | IDs of the campaigns to archive/delete. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sp_delete_keyword
Amazon Ads: SP Delete Keyword · delete, €29 plan, one object at a time · creates an object on each call
ARCHIVES Sponsored Products keywords (POST /sp/keywords/delete). IRREVERSIBLE. dry_run=true by default. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again).
| Parameter | Type | Required | Description |
|---|---|---|---|
keyword_ids | string[] | yes | IDs of the keywords. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sp_delete_negative_keyword
Amazon Ads: SP Delete Negative Keyword · delete, €29 plan, one object at a time · creates an object on each call
ARCHIVES Sponsored Products negative keywords (POST /sp/negativeKeywords/delete). IRREVERSIBLE. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again).
| Parameter | Type | Required | Description |
|---|---|---|---|
keyword_ids | string[] | yes | IDs of the negative keywords. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sp_delete_product_ad
Amazon Ads: SP Delete Product Ad · delete, €29 plan, one object at a time · creates an object on each call
ARCHIVES Sponsored Products product ads (POST /sp/productAds/delete). IRREVERSIBLE. dry_run=true by default. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again).
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_ids | string[] | yes | IDs of the product ads. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |
amazon_ads_sp_delete_target
Amazon Ads: SP Delete Target · delete, €29 plan, one object at a time · creates an object on each call
ARCHIVES Sponsored Products targeting clauses (POST /sp/targets/delete). IRREVERSIBLE. dry_run=true by default. Non-atomic batch: if Amazon rejects an item, the tool returns an ERROR that names each rejected item (index, Amazon's reason) and those already applied (do not send them again).
| Parameter | Type | Required | Description |
|---|---|---|---|
target_ids | string[] | yes | IDs of the targeting clauses. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
account_id | string | no | Amazon Ads account that owns the target object, as returned by the account listing tool. Required when the workspace has several linked accounts; otherwise its only account. |