Change campaign settings through the API

You can rename an existing campaign, change its daily budget, switch bidding strategies and update placement adjustments through the Merch Jar API.

These settings are available for Sponsored Products campaigns. API access is included on every Merch Jar plan, including legacy plans.

To build a new setup, see Create campaigns with the Copilot and API. This guide covers changes to campaigns that already exist.

Before you start

Create an API key in Settings → API Keys with the campaigns:write scope. Use the Amazon advertising profile ID and campaign ID for the campaign you want to edit. Keep IDs as strings.

If you’re using the Copilot, follow the setup guide, then describe the change you want. For example: “Rename my launch campaigns so I can tell which product each one belongs to.” Review the proposed names and affected campaigns before approving the changes.

Settings you can change

Send only the settings you want to change. For example, changing the rest-of-search adjustment leaves the other placement adjustments untouched. Send 0 explicitly to remove an existing placement increase.

Make an update

Send PATCH /api/v5/campaigns/{id} with your Bearer authorization, profileid header and a unique Idempotency-Key for the operation. This example sets the rest-of-search adjustment to 100%:

{
  "optimizations": {
    "bidSettings": {
      "bidAdjustments": {
        "placementBidAdjustments": [
          { "placement": "REST_OF_SEARCH", "percentage": 100 }
        ]
      }
    }
  }
}

Use the API reference for the exact request bodies and scopes. It includes examples for campaign creation and other entity operations.

Check the result

Inspect the response’s success, partialSuccess and error arrays. An HTTP 200 alone does not confirm every requested change succeeded. Read the campaign back after the update and compare the affected settings.

If a request times out or returns an uncertain outcome, check the campaign before sending it again. Keep the same idempotency key only for the same operation; use a new key for a different change.

For integrations reading Segment previews, fixed bids can appear as NONE and up-and-down as SALES. The update endpoint expects MANUAL and SALES_UP_AND_DOWN, respectively. Down-only uses SALES_DOWN_ONLY. Map the read values before constructing an update.

What a placement percentage means

A 100% placement adjustment doubles the base bid for that placement before other applicable bid adjustments. A 0% adjustment leaves the base bid unchanged; it does not turn the placement off. Dynamic bidding and other Amazon adjustments can change the auction bid further.

Campaign placement settings apply across the campaign. Individual keyword and target bids, and ad-group default bids, are separate settings. Changing a placement percentage does not rewrite those bids.

Campaign state changes and archival use the separate bulk-actions API. They are not supported fields in this campaign-settings PATCH request. Amazon Business and audience adjustments are also outside this endpoint’s supported placement list.