# Update Amazon Sponsored Brands extended collection creative Replace creative for Sponsored Brands ad creative product collection extended. Works on your own Amazon Ads account, connected through Get MCP Ads. The preview is free; the change costs $0.05 when you confirm it. Needs account id and payload. Replace creative for Sponsored Brands ad creative product collection extended. Native Amazon contract, single entity. Creates with a state field require PAUSED; state-less creates require a paused parent. Native brand/product eligibility and moderation apply. Preview binds current entity and parent state; confirmation can change spend. Amounts are in profile currency. No automatic retries. Agentik price: free to preview; $0.05 when the change is applied (confirm: true without validateOnly). - Tool ID: `amazon-ads/update-sb-ad-creative-product-collection-extended` - Name in the catalog: Amazon Ads: Update sb ad creative product collection extended - Provider: [Amazon Ads](/providers/amazon-ads.md) - Capability: [Amazon Ads creatives](/tools/amazon-ads/creatives.md) - Price: free preview, $0.05 per applied change - Workspace access is automatic. Connect a platform using the link and notice returned to your AI assistant; an owner or admin completes platform consent and returns to the conversation; see the [guide](/docs/getmcpads.md). - Authentication: an authorised Agentik workspace is required for execution, including zero-price tools. ## Pricing contract The provider’s price, with no markup. Billed for measured usage. ```json { "model": "per_call", "amountUsd": 0, "multipliers": [ { "all": [ { "field": "confirm", "equals": true }, { "field": "validateOnly", "truthy": false } ], "setUsd": 0.05 } ] } ``` ## Complete input schema ```json { "type": "object", "properties": { "accountId": { "type": "string", "pattern": "^(NA|EU|FE):[1-9]\\d{0,19}$", "description": "Exact selected account ID from list_accounts, including region, for example EU:123456. Regions cannot be interchanged." }, "payload": { "type": "object", "properties": { "adId": { "type": "string", "pattern": "^[1-9]\\d{0,19}$", "description": "The unique ID of a Sponsored Brands ad." }, "creative": { "type": "object", "properties": { "asins": { "type": "array", "items": { "type": "string", "maxLength": 8192, "description": "ASIN" }, "minItems": 0, "maxItems": 3, "description": "An array of ASINs associated with the creative." }, "brandLogoCrop": { "type": "object", "properties": { "top": { "type": "number", "description": "The highest pixel from which to begin cropping" }, "left": { "type": "number", "description": "The leftmost pixel from which to begin cropping" }, "width": { "type": "number", "description": "The number of pixels to crop rightwards from the value specified as left" }, "height": { "type": "number", "description": "The number of pixels to crop down from the value specified as top" } }, "additionalProperties": false, "description": "Asset cropping attributes" }, "brandName": { "type": "string", "maxLength": 8192, "description": "The displayed brand name in the ad headline.\nMaximum length is 30 characters.\nSee [the policy](https://advertising.amazon.com/resources/ad-policy/sponsored-ads-policies#headlines) for headline requirements." }, "landingPage": { "type": "object", "properties": { "asins": { "type": "array", "items": { "type": "string", "maxLength": 8192, "description": "ASIN" }, "minItems": 0, "maxItems": 100, "description": "The list of asins on the landingPage If type is PRODUCT_LIST. A minimum of 3 asins are required. For the 'PRODUCT_LIST' type, the asins property is mandatory, and the url should not be included." }, "type": { "type": "string", "maxLength": 8192, "description": "Supported types are PRODUCT_LIST, STORE, DETAIL_PAGE, CUSTOM_URL. More could be added in future." }, "url": { "type": "string", "maxLength": 8192, "description": "The url of the landingPage. When including the 'asins' property in the request, do not include this property, as they are mutually exclusive. For the PRODUCT_LIST type, the asins property is mandatory, and the url should not be included." } }, "additionalProperties": false, "description": "Landing page V2, where type is String with allowed values listed, and url or asins of that type." }, "customImages": { "type": "array", "items": { "type": "object", "properties": { "assetId": { "type": "string", "maxLength": 8192 }, "crop": { "type": "object", "properties": { "top": { "type": "number" }, "left": { "type": "number" }, "width": { "type": "number" }, "height": { "type": "number" } }, "additionalProperties": false, "description": "The crop to apply to the selected Custom image. A Custom image must have a 1200x628 aspect ratio, with a .01 delta for floating point precision. If a customImageAssetId is supplied but a crop is not, the crop will be defaulted to the whole image." }, "url": { "type": "string", "maxLength": 8192 } }, "additionalProperties": false }, "minItems": 1, "maxItems": 5, "description": "An array of customImages associated with the creative." }, "consentToTranslate": { "type": "boolean", "description": "If set to true and the headline and/or video are not in the marketplace's default language, Amazon will attempt to translate them to the marketplace's default language.\nIf Amazon is unable to translate them, the ad will be rejected by moderation. We only support translating headlines and videos from English to German, French, Italian, Spanish, Japanese, and Dutch. See developer notes for more info" }, "creativePropertiesToOptimize": { "type": "array", "items": { "type": "string", "enum": [ "HEADLINE" ], "description": "| CreativePropertyToOptimize | Description |\n|------------------------------------|-----------------------------------------------------------------------------------------|\n| HEADLINE | Optimizes headlines by leveraging provided versions and customizing them based on f" }, "minItems": 0, "maxItems": 1, "description": "If this property is enabled, Sponsored Brands will dynamically optimize by enhancing or generating creative properties based on shopper search intent." }, "brandLogoAssetId": { "type": "string", "maxLength": 8192, "description": "The identifier of the [brand logo](https://advertising.amazon.com/resources/ad-policy/sponsored-ads-policies#brandlogo) image from the brand store's asset library.\nNote that for campaigns created in the Amazon Advertising console prior to release of the brand store's assets library, responses will not include a value for this field." }, "headline": { "type": "string", "maxLength": 8192, "description": "The headline text. Maximum length of the string is 50 characters for all marketplaces other than Japan, which has a maximum length of 35 characters.\nSee [the policy](https://advertising.amazon.com/resources/ad-policy/sponsored-ads-policies#headlines) for headline requirements." } }, "required": [ "asins", "brandName", "brandLogoAssetId", "headline" ], "additionalProperties": false } }, "required": [ "adId", "creative" ], "additionalProperties": false, "description": "Native fields for one entity, without Amazon's bulk wrapper. Integer identifiers must be decimal strings. Only documented fields are accepted." }, "confirm": { "type": "boolean", "default": false, "description": "Preview first; confirm only the exact change authorized by the user." }, "previewToken": { "type": "string", "maxLength": 16000, "description": "Exact preview token, valid ten minutes in this workspace and profile." }, "workspace_id": { "type": "string", "description": "Authorized workspace ID from list_accounts/list_workspaces. Use the user's chosen workspace; never guess between clients. Optional when a unique account identifies it." }, "reason": { "type": "string", "maxLength": 500, "description": "Why, in the person's words or from the evidence (e.g. CPA twice the target for 7 days). Saved with the change in the shared client journal." } }, "required": [ "accountId", "payload" ] } ``` ## Published example No example input is published for this tool. Ask for the inputs required by its schema. ## Execute and retrieve Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative. A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md). [REST inspection](https://api.agentik.cc/v1/tools/amazon-ads/update-sb-ad-creative-product-collection-extended) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md) --- [HTML page](/providers/amazon-ads/update-sb-ad-creative-product-collection-extended) · [Agent index](/llms.txt)