Some Claude users report missing tools, which can cause problems with operations such as creating Actions or Exports.
If you experience this issue, manually refresh the tools in Claude: Customize → Connectors settings → Refresh Tools List.
If issues continue, please contact us.
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.
- 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_UPDATE(W, Sellers & Vendors) | Easy way to update basic Amazon listing parameters, including name, bullet points, keywords, and images. Sellers can also update price. | 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_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. | 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 |
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. | - |
Listing images
To update listing images, upload files to the LISTING_IMAGES group first, then reference file UUIDs in 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.
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.