What are DataDoe Actions?
Actions let your AI agents and integrations act on your Amazon account through DataDoe. They can read data and make changes, such as updating listings, cancelling orders, confirming shipments, and managing ads. Every Action runs through DataDoe MCP or the REST API and is monitored and auditable. See Subscription & Pricing for Action costs.
You are responsible for the results of Actions you run. Review every payload before running an Action.
How to enable Actions?
All Action types are disabled by default for every organization. You can enable specific Action types in Settings > Actions (opens in a new tab). When an Action type is disabled, MCP and API reject requests to run Actions of this type, but dryRun is still possible. New Action types are disabled by default.
In order to start an Action for a Seller or Vendor, its access level must be set to 'Read and write' on the Accounts page (opens in a new tab).
How to run Actions?
Using MCP
- Connect DataDoe to Claude, ChatGPT, or another MCP-capable agent.
- Get the payload schema for the Action type you want to run using the
actions_details_schema_gettool. - Use the payload schema, data from DataDoe, and other inputs to build your Action payload.
- Validate the Action payload using the
actions_starttool withdryRun=true. - Start the Action using the
actions_starttool. - Poll for the Action status using the
actions_gettool. - Read the Action result in the
resultfield of the Action response.
You can also get all your past Actions using the actions_list tool.
Using API
The easiest way to run Actions with the API is to paste this page URL into your coding AI agent and ask it to generate the code for you.
Authenticate every REST request with the datadoe-api-key header. Do not use X-Api-Key or Authorization.
1POST /api/v1/actions
2Content-Type: application/json
3datadoe-api-key: YOUR_API_KEY- Set up your DataDoe API connection.
- Check the payload schema for the Action type you want to run in the request body schema (opens in a new tab) for the
POST /actions/startresource. - Use the payload schema, data from DataDoe, and other inputs to build your Action payload.
- Validate the Action payload using the
POST /actionsresource withdryRun=true. - Start the Action using the
POST /actionsresource. - Poll for the Action status using the
GET /actions/<action_id>resource. - Read the Action result in the
resultfield of the Action response.
You can also get all your past Actions using the GET /actions resource.
All details about the API are available in the DataDoe API docs (opens in a new tab).
What are the live Actions limits?
DataDoe limits how many live Actions you can have at the same time:
- up to 500 per organization,
- and up to 25 per Seller or Vendor connection.
If you exceed a limit, starting a new Action is rejected (HTTP 429 for the API). A live Action is any Action that is PENDING, IN_PROGRESS, or WAITING_EXTERNAL_PROCESSING. Actions sent in dryRun mode are not counted toward these limits.
Wait for existing Actions to complete or combine multiple operations into a single Action request to stay within the limits.
What are the available operation types?
The following operation types are available:
- Write: Create, update, or delete an entity.
- Read: Read an entity to verify its state before or after an operation.
Read operations in Actions are only for verification steps in flows built with Actions. They should not be used for analysis, planning changes, or reporting. For these tasks, use our data tables.
What are the available Actions?
W in brackets means write operations, R in brackets means read operations.
Both are followed by the avaibility for Sellers and Vendors.
Amazon - Listings Actions
| Action type | Action description | Action Result data | Max. items (API/MCP) |
|---|---|---|---|
AMAZON_LISTINGS_CREATE(W, Sellers & Vendors) | Create new Amazon listings, including images. | Confirmation that Amazon accepted the Action. | 5000/20 |
AMAZON_LISTINGS_UPDATE(W, Sellers & Vendors) | Easy way to update basic Amazon listing parameters, like name, bullet points, keywords, and images. | Confirmation that Amazon accepted the Action. | 5000/50 |
AMAZON_LISTINGS_PRICING_UPDATE(W, Sellers only) | Easy way to update Amazon listing prices. | Confirmation that Amazon accepted the Action. | 5000/50 |
AMAZON_LISTINGS_DETAILS_UPDATE(W, Sellers & Vendors) | Advanced way to update arbitrary Amazon listing attributes. | Confirmation that Amazon accepted the Action. | 5000/50 |
AMAZON_LISTINGS_FIND(R, Sellers & Vendors) | Find Amazon listings by given identifier (like SKU, ASIN, or UPC). | Full models of found listings. | 5000/300 |
AMAZON_LISTINGS_FEES_ESTIMATE(R, Sellers only) | Estimate Amazon listing fees for ASINs or SKUs at a given listing and shipping price. | Estimated fee breakdown per item. | 2500/300 |
AMAZON_LISTINGS_FEATURED_PRICE_ESTIMATE(R, Sellers only) | Estimate the featured offer expected price (FOEP) for seller SKUs. Supports an optional location segment (countryCode + postalCode). Does not guarantee Featured Offer placement. | Full Amazon FOEP response body per SKU. | 120/40 |
AMAZON_LISTINGS_COMPETITIVE_SUMMARY_FIND(R, Sellers only) | Find competitive summary data for ASINs, including featured buying options, reference prices, lowest-priced offers, and similar items. Supports optional per-ASIN lowest-priced-offer filters. | Full Amazon competitive summary body per ASIN. | 60/20 |
AMAZON_LISTINGS_PRODUCT_TYPES_FIND(R, Sellers & Vendors) | List available Amazon product types for the Seller or Vendor. | Available product types. | 1/1 |
AMAZON_LISTINGS_PRODUCT_TYPE_SUGGEST(R, Sellers & Vendors) | Suggest Amazon product types for given product names. | Suggested product types per name. | 1000/100 |
AMAZON_LISTINGS_PRODUCT_TYPE_DEFINITION_FIND(R, Sellers & Vendors) | Retrieve Amazon product type definition schemas for SKUs or product types. Required to use AMAZON_LISTINGS_DETAILS_UPDATE and AMAZON_LISTINGS_CREATE. | Product type definition and JSON schema. | 5/1 |
Amazon - A+ Content Actions
| Action type | Action description | Action Result data | Max. items (API/MCP) |
|---|---|---|---|
AMAZON_APLUS_CONTENT_ADD(W, Sellers & Vendors) | Create Amazon A+ Content documents and optionally associate ASINs. | Created content document reference keys. | 10/5 |
AMAZON_APLUS_CONTENT_UPDATE(W, Sellers & Vendors) | Update an existing Amazon A+ Content document. | Confirmation that Amazon accepted the Action. | 10/5 |
AMAZON_APLUS_CONTENT_FIND(R, Sellers & Vendors) | Search or retrieve Amazon A+ Content documents by content reference key. | Content documents and metadata. | 50/20 |
AMAZON_APLUS_CONTENT_ASINS_UPDATE(W, Sellers & Vendors) | Associate or update ASIN relations for an A+ Content document. | Confirmation that Amazon accepted the Action. | 10/5 |
AMAZON_APLUS_CONTENT_ASINS_FIND(R, Sellers & Vendors) | List ASIN relations for A+ Content documents. | ASIN relations per document. | 50/25 |
AMAZON_APLUS_CONTENT_VALIDATE(R, Sellers & Vendors) | Validate A+ Content documents and ASIN relations before publishing. | Validation results per document. | 10/5 |
AMAZON_APLUS_CONTENT_PUBLISH(W, Sellers & Vendors) | Submit an A+ Content document for Amazon approval. | Confirmation that Amazon accepted the Action. | 50/25 |
AMAZON_APLUS_CONTENT_SUSPEND(W, Sellers & Vendors) | Suspend a published A+ Content document. | Confirmation that Amazon accepted the Action. | 50/25 |
AMAZON_APLUS_CONTENT_PUBLISH_RECORDS_FIND(R, Sellers & Vendors) | Search A+ Content publish records by ASIN. | Publish records per ASIN. | 100/50 |
Amazon - Orders Actions
| Action type | Action description | Action Result data | Max. items (API/MCP) |
|---|---|---|---|
AMAZON_ORDERS_CANCEL(W, Sellers only) | Cancel an Amazon order item with a given cancellation reason. | Confirmation that Amazon accepted the Action. | 5000/50 |
AMAZON_ORDERS_CONFIRM_SHIPMENT(W, Sellers only) | Confirm shipment for an Amazon order item and upload tracking information. | Confirmation that Amazon accepted the Action. | 5000/50 |
AMAZON_ORDERS_SOLICITATION_FEEDBACK_SEND(W, Sellers only) | Send a product review and seller feedback solicitation for an Amazon order. | Confirmation that Amazon accepted the Action. | 300/300 |
AMAZON_ORDERS_GET_SHIPPING_RATES(R, Sellers only) | Get Amazon Buy Shipping rates for an FBM order. Copy format, size, and if needed dpi / pageLayout from supportedDocumentSpecifications onto CREATE. shipFrom.countryCode is ISO 3166-1 alpha-2 (GB, not marketplace UK). | Slim rates, ineligible rates, and a requestToken that expires in about 10 minutes. | 10/5 |
AMAZON_ORDERS_CREATE_SHIPMENT(W, Sellers only) | Purchase an Amazon Buy Shipping label for an FBM order. Requires documentSize copied from the chosen rate. If purchase times out, do not buy again; GET_SHIPMENT_DOCS only works with a known shipmentId. | Shipment and tracking ids, a signed labelDownloadUrl valid until expiresAt (~15 min). Reprint via AMAZON_ORDERS_GET_SHIPMENT_DOCS. Amazon still has the document after the S3 object is gone (7 days). | 10/5 |
AMAZON_ORDERS_GET_SHIPMENT_DOCS(R, Sellers only) | Re-fetch Amazon Buy Shipping documents when reprinting or when a signed URL expired. Requires a known shipmentId and packageClientReferenceId. | Document metadata and a fresh signed labelDownloadUrl valid until expiresAt (~15 min). | 20/10 |
AMAZON_ORDERS_CANCEL_SHIPMENT(W, Sellers only) | Void a paid Amazon Buy Shipping label before carrier scan. | { shipmentId, canceled: true }. Requires confirm: true. | 20/10 |
Amazon - MCF Actions
MCF order lifecycle uses Fulfillment Outbound v2026-07-04. Return actions use v2020-07-01 because Amazon has not ported returns to v2026.
| Action type | Action description | Action Result data | Max. items (API/MCP) |
|---|---|---|---|
AMAZON_MCF_ORDERS_ADD(W, Sellers only) | Create an MCF order so Amazon can pick, pack, and ship FBA inventory to a non-Amazon customer. | Confirmation that Amazon accepted the order. | 10/5 |
AMAZON_MCF_ORDERS_UPDATE(W, Sellers only) | Hold or ship an existing MCF order. | Confirmation that Amazon accepted the update. | 25/10 |
AMAZON_MCF_ORDERS_FIND(R, Sellers only) | Operational lookup of recent MCF orders. Not for analytics — warehouse reporting stays in data tables / BigQuery (same rule as listings find). Returns one page per call and does not auto-paginate. | MCF order list or a single order. | 100/25 |
AMAZON_MCF_ORDERS_CANCEL(W, Sellers only) | Cancel an MCF order. | Confirmation that Amazon accepted the cancellation. | 50/20 |
AMAZON_MCF_ORDERS_PREVIEW(R, Sellers only) | Draft a full MCF order preview (getOrderPreview) including line items and destination. | Amazon order preview, including estimated fees. | 20/10 |
AMAZON_MCF_DELIVERY_OFFERS_PREVIEW(R, Sellers only) | Retrieve MCF delivery offers (getOffers) for one or more SKUs. Origin is taken from the connection marketplace. | Amazon delivery offers. | 20/10 |
AMAZON_MCF_RETURNS_REASON_CODES_FIND(R, Sellers only) | Look up MCF return reason codes via Fulfillment Outbound v2020-07-01 (listReturnReasonCodes). Marketplace comes from the connection. | Return reason codes per SKU. | 10/5 |
AMAZON_MCF_RETURNS_ADD(W, Sellers only) | Create an MCF fulfillment return via Fulfillment Outbound v2020-07-01 (createFulfillmentReturn). | Confirmation that Amazon accepted the return. | 25/10 |
AMAZON_MCF_FEATURES_MARKETPLACE_FIND(R, Sellers only) | Return the static catalog of v2026 MCF fulfillmentConfiguration.services options. Does not call Amazon. | Static services catalog. | 1/1 |
AMAZON_MCF_FEATURES_SKU_FIND(R, Sellers only) | Check whether a SKU is sellable and what quantity Amazon can fulfill, using getOrderPreview as a proxy. Not a full MCF order draft — use AMAZON_MCF_ORDERS_PREVIEW for that. | Preview-backed sellability and quantity per SKU. | 10/5 |
The following Actions are available for Amazon Seller Central and Vendor Central:
Amazon Ads Actions
Amazon Ads Action models and flows follow the structure shown in the Amazon Ads API documentation (opens in a new tab).
The following Actions are available for Amazon Ads:
| Action type | Action description | Action Result data | Max. items (API/MCP) |
|---|---|---|---|
AMAZON_ADS_CAMPAIGNS_ADD(W, Sellers & Vendors) | Add Amazon Ads campaigns | Created campaign entities. | 250/25 |
AMAZON_ADS_CAMPAIGNS_UPDATE(W, Sellers & Vendors) | Update Amazon Ads campaigns | Full model of updated campaigns. | 250/25 |
AMAZON_ADS_CAMPAIGNS_REMOVE(W, Sellers & Vendors) | Remove Amazon Ads campaigns | Empty response. | 250/25 |
AMAZON_ADS_CAMPAIGNS_FIND(R, Sellers & Vendors) | Find Amazon Ads campaigns | Full model of found campaigns. | - |
AMAZON_ADS_AD_GROUPS_ADD(W, Sellers & Vendors) | Add Amazon Ads ad groups | Created ad group entities. | 250/25 |
AMAZON_ADS_AD_GROUPS_UPDATE(W, Sellers & Vendors) | Update Amazon Ads ad groups | Full model of updated ad groups. | 250/25 |
AMAZON_ADS_AD_GROUPS_REMOVE(W, Sellers & Vendors) | Remove Amazon Ads ad groups | Empty response. | 250/25 |
AMAZON_ADS_AD_GROUPS_FIND (R) | Sellers & Vendors | Find Amazon Ads ad groups | Full model of found ad groups. |
AMAZON_ADS_TARGETS_ADD(W, Sellers & Vendors) | Add Amazon Ads targets | Created target entities. | 250/25 |
AMAZON_ADS_TARGETS_UPDATE(W, Sellers & Vendors) | Update Amazon Ads targets | Full model of updated targets. | 250/25 |
AMAZON_ADS_TARGETS_REMOVE(W, Sellers & Vendors) | Remove Amazon Ads targets | Empty response. | 250/25 |
AMAZON_ADS_TARGETS_FIND(R, Sellers & Vendors) | Find Amazon Ads targets | Full model of found targets. | - |
AMAZON_ADS_ADS_ADD(W, Sellers & Vendors) | Add Amazon Ads ads | Created ad entities. | 250/25 |
AMAZON_ADS_ADS_UPDATE(W, Sellers & Vendors) | Update Amazon Ads ads | Full model of updated ads. | 250/25 |
AMAZON_ADS_ADS_REMOVE(W, Sellers & Vendors) | Remove Amazon Ads ads | Empty response. | 250/25 |
AMAZON_ADS_ADS_FIND(R, Sellers & Vendors) | Find Amazon Ads ads | Full model of found ads. | - |
AMAZON_ADS_AD_ASSOCIATIONS_ADD(W, Sellers & Vendors) | Add Amazon Ads ad associations | Created ad association entities. | 250/25 |
AMAZON_ADS_AD_ASSOCIATIONS_UPDATE(W, Sellers & Vendors) | Update Amazon Ads ad associations | Full model of updated ad associations. | 250/25 |
AMAZON_ADS_AD_ASSOCIATIONS_REMOVE(W, Sellers & Vendors) | Remove Amazon Ads ad associations | Empty response. | 250/25 |
AMAZON_ADS_AD_ASSOCIATIONS_FIND(R, Sellers & Vendors) | Find Amazon Ads ad associations | Full model of found ad associations. | - |
AMAZON_ADS_PORTFOLIOS_ADD(W, Sellers & Vendors) | Add Amazon Ads portfolios | Created portfolio entities. | 250/25 |
AMAZON_ADS_PORTFOLIOS_UPDATE(W, Sellers & Vendors) | Update Amazon Ads portfolios | Full model of updated portfolios. | 250/25 |
AMAZON_ADS_PORTFOLIOS_FIND(R, Sellers & Vendors) | Find Amazon Ads portfolios | Full model of found portfolios. | - |
AMAZON_ADS_SP_BID_RECOMMENDATIONS_FIND(R, Sellers & Vendors) | Find Sponsored Products bid recommendations for existing ad groups | Bid recommendations per targeting. | 50/20 |
AMAZON_ADS_SP_TARGET_RECOMMENDATIONS_FIND(R, Sellers & Vendors) | Find Sponsored Products keyword target recommendations for existing ad groups | Ranked keyword target recommendations. | 50/20 |
Sponsored Products Auto campaigns
Automatic vs manual targeting is locked when the campaign is created. Use AMAZON_ADS_CAMPAIGNS_ADD with targetingType: "AUTO" (preferred) or autoCreationSettings.autoCreateTargets: true. Then create an ad group and at least one product ad. Amazon creates the four Auto theme targets (Close Match, Loose Match, Substitutes, Complements). List them with AMAZON_ADS_TARGETS_FIND and optionally set bids with AMAZON_ADS_TARGETS_UPDATE or AMAZON_ADS_SP_BID_RECOMMENDATIONS_FIND.
Do not set targetingType or autoCreationSettings on AMAZON_ADS_CAMPAIGNS_UPDATE. To change Auto vs Manual, create a new campaign.
Listing images
To set listing images on create or update, upload files to the LISTING_IMAGES group first, then reference file UUIDs in AMAZON_LISTINGS_CREATE or AMAZON_LISTINGS_UPDATE. See Files for upload details and Actions - Manage Images for the full workflow, slot mapping, and MCP and API examples.
A+ Content images
To include images in A+ Content documents, upload files to the APLUS_IMAGES group first, then reference file UUIDs in image components inside AMAZON_APLUS_CONTENT_ADD, AMAZON_APLUS_CONTENT_UPDATE, or AMAZON_APLUS_CONTENT_VALIDATE.
AMAZON_APLUS_CONTENT_FIND skips Amazon premium A+ modules (for example premium-module-2-fullbackground-image). Those documents are listed under skipped and do not fail the Action. Premium A+ cannot be round-tripped via SP-API.
How long does an Action take to complete?
DataDoe runs the Action on Amazon within 15 minutes of the Action starting.
Seller Central and Vendor Central listing changes may take 5 minutes to a few hours for Amazon to process. Amazon Ads changes are processed in real time.