# Amazon Ads

Source: https://pilot.braike.com/en/docs/regies/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_`.

<Callout title="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.
</Callout>

<Callout title="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](/en/docs/limites-et-forfaits#ecritures).
</Callout>

## Tool families [#familles]

| Family | Tools |
| --- | ---: |
| [Other tools](#autres) | 25 |
| [Create and change (€29)](#modification) | 36 |
| [Delete (€29)](#suppression) | 17 |

## Other tools [#autres]

### `amazon_ads_create_report` [#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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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) [#modification]

Served with the €29 plan.

### `amazon_ads_sb_create_ad` [#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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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) [#suppression]

Served with the €29 plan. A deletion targets one object at a time.

### `amazon_ads_sb_delete_ad` [#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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

**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]

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