ads_create_ad
Create ads (creatives) across ALL ad products via the unified Amazon Ads API v1.
writeAmazon Adsads.v1
In the v1 model an "ad" is the creative unit inside an ad group; a sponsored ad's advertised product is inside its creative (productCreative for SP, componentCreative for SB and SD, videoCreative for ST) — ad associations (ads_query_ad_association) are AMAZON_DSP's ad-to-ad-group links, not product links. Amazon Ads API · CreateAd · POST /adsApi/v1/create/ads Docs: https://advertising.amazon.com/API/docs/en-us/api-spec-v1-ads#tag/Ads/operation/CreateAd Gate: approve — interactive: show the change (Amazon's preview first where one exists), wait for an explicit approve; autopilot: only when the seller's own words asked for this change; otherwise ask.
Call it
In an AI client (MCP)
{
"name": "ads_create_ad",
"arguments": {
"store": "myStore-US",
"countryCode": "<countryCode>",
"body": "<body>"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/ads_create_ad \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US","countryCode":"<countryCode>","body":"<body>"}'Arguments
| Name | Type | Description |
|---|---|---|
storerequired | string | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. |
countryCoderequired | string | the Ads profile's 2-letter country code (e.g. 'US'). |
bodyrequired | object[] | object | list of ad objects (or {ads: [...]}). |
Result
Every tool answers {notification, data, human_action}; data carries:
- 207 {success, partialSuccess, error}. HTTP success does not mean every item succeeded; read error[] by index.
data.result.success[].ad— each created ad with its adId; index is its position in your list — partialSuccess[] items were created with errors, error[] items were not.
Gotchas
- adGroupId is REQUIRED for SPONSORED_PRODUCTS, SPONSORED_BRANDS, SPONSORED_DISPLAY and SPONSORED_TELEVISION — only AMAZON_DSP creates ads without an ad group.
- adType and creative follow adProduct: SP PRODUCT_AD + productCreative, SB and SD COMPONENT + componentCreative, ST VIDEO + videoCreative (SB and ST also require name); AUDIO, DISPLAY and THIRD_PARTY are AMAZON_DSP's.
- productIdType is SKU or ASIN (SP also lists RETAILER_OFFER); a SELLER should use SKU (one SKU names exactly one ASIN, whereas one ASIN can cover several SKUs) — a VENDOR account has no seller SKUs and uses ASIN. SB creatives are ASIN-only.
- A well-formed create can still fail per-index with PRODUCT_INELIGIBLE when the product is not currently buyable — check listing status first.