PilotMCP
Platforms and tools

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

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).

ParameterTypeRequiredDescription
namestringnoReport name (optional).
start_datestringyesStart date, YYYY-MM-DD.
end_datestringyesEnd date, YYYY-MM-DD.
ad_productstringyesAdvertising program targeted. Values: "SPONSORED_PRODUCTS", "SPONSORED_BRANDS", "SPONSORED_DISPLAY".
report_type_idstringyesReport type (must match ad_product). Values: "spCampaigns", "sbCampaigns", "sdCampaigns".
group_bystring[]noGrouping dimensions, e.g. ['campaign']. Default: ["campaign"].
columnsstring[]yesColumns/metrics, e.g. ['impressions','clicks','cost','campaignId','campaignName'].
time_unitstringnoTime granularity. Values: "SUMMARY", "DAILY". Default: "SUMMARY".
account_idstringnoAmazon 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}).

ParameterTypeRequiredDescription
profile_idstringyesID 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.

ParameterTypeRequiredDescription
report_idstringyesReport ID (returned by create_report).
downloadbooleannoIf true and status=COMPLETED, downloads and gunzips the file and returns the rows. Default: false.
max_rowsnumbernoMaximum number of rows returned when download is set. Default: 1000.
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
campaign_id_filterstring[]no
state_filterstring[]noValues: "ENABLED", "PAUSED", "ARCHIVED".
max_resultsintegernoMaximum number of items read, across all pages (default 100, at most 5000). Default: 100.
next_tokenstringnoResumes a truncated list: the value of data.pagination.suite from the previous response.
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
campaign_id_filterstring[]no
ad_group_id_filterstring[]no
max_resultsintegernoMaximum number of items read, across all pages (default 100, at most 5000). Default: 100.
next_tokenstringnoResumes a truncated list: the value of data.pagination.suite from the previous response.
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
state_filterstring[]noValues: "ENABLED", "PAUSED", "ARCHIVED".
max_resultsintegernoMaximum number of items read, across all pages (default 100, at most 5000). Default: 100.
next_tokenstringnoResumes a truncated list: the value of data.pagination.suite from the previous response.
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
start_indexintegernoStarting position (0 = the first item). To resume a truncated list: data.pagination.suite. Default: 0.
countintegernoMaximum number of items read, across all pages (default 100, at most 5000). The server reads in pages of 100. Default: 100.
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
start_indexintegernoStarting position (0 = the first item). To resume a truncated list: data.pagination.suite. Default: 0.
countintegernoMaximum number of items read, across all pages (default 100, at most 5000). The server reads in pages of 100. Default: 100.
campaign_id_filterstring[]noCampaign IDs.
ad_group_id_filterstring[]noAd group IDs.
keyword_id_filterstring[]noNegative keyword IDs.
state_filterstring[]noValues: "enabled", "paused", "archived".
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
max_resultsintegernoMaximum number of items read, across all pages (default 100, at most 5000). Default: 100.
next_tokenstringnoResumes a truncated list: the value of data.pagination.suite from the previous response.
account_idstringnoAmazon 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}).

ParameterTypeRequiredDescription
campaign_idstringyesID of the SD campaign.
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
start_indexintegernoStarting position (0 = the first item). To resume a truncated list: data.pagination.suite. Default: 0.
countintegernoMaximum number of items read, across all pages (default 100, at most 5000). The server reads in pages of 100. Default: 100.
state_filterstring[]noValues: "enabled", "paused", "archived".
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
start_indexintegernoStarting position (0 = the first item). To resume a truncated list: data.pagination.suite. Default: 0.
countintegernoMaximum number of items read, across all pages (default 100, at most 5000). The server reads in pages of 100. Default: 100.
state_filterstring[]noFilter by state (lowercase). Values: "enabled", "paused", "archived".
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
start_indexintegernoStarting position (0 = the first item). To resume a truncated list: data.pagination.suite. Default: 0.
countintegernoMaximum number of items read, across all pages (default 100, at most 5000). The server reads in pages of 100. Default: 100.
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
start_indexintegernoStarting position (0 = the first item). To resume a truncated list: data.pagination.suite. Default: 0.
countintegernoMaximum number of items read, across all pages (default 100, at most 5000). The server reads in pages of 100. Default: 100.
campaign_id_filterstring[]noCampaign IDs.
ad_group_id_filterstring[]noAd group IDs.
state_filterstring[]noValues: "enabled", "paused", "archived".
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
start_indexintegernoStarting position (0 = the first item). To resume a truncated list: data.pagination.suite. Default: 0.
countintegernoMaximum number of items read, across all pages (default 100, at most 5000). The server reads in pages of 100. Default: 100.
state_filterstring[]noValues: "enabled", "paused", "archived".
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
start_indexintegernoStarting position (0 = the first item). To resume a truncated list: data.pagination.suite. Default: 0.
countintegernoMaximum number of items read, across all pages (default 100, at most 5000). The server reads in pages of 100. Default: 100.
state_filterstring[]noValues: "enabled", "paused", "archived".
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
campaign_id_filterstring[]noFilter by campaignId.
state_filterstring[]noFilter by state. Values: "ENABLED", "PAUSED", "ARCHIVED".
max_resultsintegernoMaximum number of items read, across all pages (default 100, at most 5000). Default: 100.
next_tokenstringnoResumes a truncated list: the value of data.pagination.suite from the previous response.
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
max_resultsintegernoMaximum number of items read, across all pages (default 100, at most 5000). Default: 100.
next_tokenstringnoResumes a truncated list: the value of data.pagination.suite from the previous response.
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
state_filterstring[]noFilter by state (UPPERCASE). Values: "ENABLED", "PAUSED", "ARCHIVED".
max_resultsintegernoMaximum number of items read, across all pages (default 100, at most 5000). Default: 100.
next_tokenstringnoResumes a truncated list: the value of data.pagination.suite from the previous response.
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
ad_group_id_filterstring[]no
state_filterstring[]noValues: "ENABLED", "PAUSED", "ARCHIVED".
max_resultsintegernoMaximum number of items read, across all pages (default 100, at most 5000). Default: 100.
next_tokenstringnoResumes a truncated list: the value of data.pagination.suite from the previous response.
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
campaign_id_filterstring[]no
ad_group_id_filterstring[]no
negative_keyword_id_filterstring[]no
state_filterstring[]noValues: "ENABLED", "PAUSED", "ARCHIVED".
max_resultsintegernoMaximum number of items read, across all pages (default 100, at most 5000). Default: 100.
next_tokenstringnoResumes a truncated list: the value of data.pagination.suite from the previous response.
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
ad_group_id_filterstring[]noFilter by adGroupId.
state_filterstring[]noValues: "ENABLED", "PAUSED", "ARCHIVED".
max_resultsintegernoMaximum number of items read, across all pages (default 100, at most 5000). Default: 100.
next_tokenstringnoResumes a truncated list: the value of data.pagination.suite from the previous response.
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
ad_group_id_filterstring[]no
state_filterstring[]noValues: "ENABLED", "PAUSED", "ARCHIVED".
max_resultsintegernoMaximum number of items read, across all pages (default 100, at most 5000). Default: 100.
next_tokenstringnoResumes a truncated list: the value of data.pagination.suite from the previous response.
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
entitystringyesEntity 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".
operationstringyesOperation to validate. Values: "create", "update".
payloadobjectyesOperation body (camelCase API keys: name, campaignId, state, matchType...).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
ad_formatstringyesValues: "productCollection", "productCollectionExtended", "storeSpotlight", "video", "brandVideo", "autoCollection", "manualCollection".
adsobject[]yesArray of ad objects of the chosen format.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
ad_groupsobject[]yesArray of SB v4 ad group objects (name, campaignId, state).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
campaignsobject[]yesArray of SB v4 campaign objects (name, budgetType, budget, state, startDate...).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
keywordsobject[]yesArray of keyword objects (campaignId, adGroupId, keywordText, matchType, bid, state).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
negative_keywordsobject[]yesArray of negative keyword objects (campaignId, adGroupId, keywordText, matchType).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
targetsobject[]yesArray of target objects (campaignId, adGroupId, expression[], bid, state).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
adsobject[]yesArray of ad objects with adId + fields to change (state...).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
ad_groupsobject[]yesArray of { adGroupId, name?, state? }.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
campaignsobject[]yesArray of campaign objects with campaignId + fields to change (state, budget, name).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
keywordsobject[]yesArray of keyword objects with keywordId + fields (bid, state).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
targetsobject[]yesArray of target objects with targetId, adGroupId, campaignId + fields (bid, state).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
ad_groupsobject[]yesArray of SD ad group objects (name, campaignId, defaultBid, state).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
campaignsobject[]yesArray of SD campaign objects (name, budget, budgetType, state, tactic, startDate...).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
creativesobject[]yesArray of creative objects (adGroupId, name, type, properties...).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
negative_targetsobject[]yesArray of negative target objects (adGroupId, state, expressionType, expression[]).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
product_adsobject[]yesArray of product ad objects (campaignId, adGroupId, asin OR sku, state).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
targetsobject[]yesArray of target objects (campaignId, adGroupId, expression[], bid, state).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
ad_groupsobject[]yesArray of ad group objects with adGroupId + fields (state, defaultBid, name).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
campaignsobject[]yesArray of campaign objects with campaignId + fields (state, budget, name).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
creativesobject[]yesArray of { creativeId, properties } (headline, brandLogo, video... depending on the creative type).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
product_adsobject[]yesArray of { adId, state }.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
targetsobject[]yesArray of target objects with targetId + fields (bid, state).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
ad_groupsobject[]yesArray of ad group objects (name, campaignId, defaultBid, state).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
budget_rules_detailsobject[]yesArray of budgetRuleDetails objects (name, recurrence, budgetIncreaseBy...).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
campaignsobject[]yesArray of campaign objects (API keys: name, targetingType, state, budget{budget,budgetType}, startDate...).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
keywordsobject[]yesArray of keyword objects (campaignId, adGroupId, keywordText, matchType EXACT/PHRASE/BROAD, bid, state).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
negative_keywordsobject[]yesArray of negative keyword objects (campaignId, adGroupId, keywordText, matchType, state).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
product_adsobject[]yesArray of product ad objects (campaignId, adGroupId, asin OR sku, state).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
targeting_clausesobject[]yesArray of targeting clause objects (campaignId, adGroupId, expression[], bid, state).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
ad_groupsobject[]yesArray of ad group objects with adGroupId + fields to change.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
budget_rules_detailsobject[]yesArray of { ruleId, ruleDetails?, ruleState? }.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
campaignsobject[]yesArray of campaign objects with campaignId + fields to change (state, budget, name...).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
keywordsobject[]yesArray of keyword objects with keywordId + fields (bid, state).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
negative_keywordsobject[]yesArray of { keywordId, state }.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
product_adsobject[]yesArray of { adId, state }.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
targeting_clausesobject[]yesArray of targeting clause objects with targetId + fields (bid, state).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
ad_idsstring[]yesIDs of the ads.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
ad_group_idsstring[]yesIDs of the ad groups.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
campaign_idsstring[]yesIDs of the campaigns.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
keyword_idstringyesID of the keyword to archive.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
keyword_idstringyesID of the negative keyword to archive.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
target_idstringyesID of the target to archive.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
ad_group_idstringyesID of the ad group to archive.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
campaign_idstringyesID of the campaign to archive.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
negative_target_idstringyesID of the negative target to archive.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
ad_idstringyesID of the product ad to archive.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

ParameterTypeRequiredDescription
target_idstringyesID of the target to archive.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
ad_group_idsstring[]yesIDs of the ad groups.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
campaign_idsstring[]yesIDs of the campaigns to archive/delete.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
keyword_idsstring[]yesIDs of the keywords.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
keyword_idsstring[]yesIDs of the negative keywords.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
ad_idsstring[]yesIDs of the product ads.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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).

ParameterTypeRequiredDescription
target_idsstring[]yesIDs of the targeting clauses.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).
account_idstringnoAmazon 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.

On this page