Actions | DataDoe

Ongoing issues with MCP tools discovery in Claude

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.

Actions are live and available to all DataDoe organisations.

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 organisation. You can enable specific Action types in Settings > Actions. 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.

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_get tool.
Use the payload schema, data from DataDoe, and other inputs to build your Action payload.
Validate the Action payload using the actions_start tool with dryRun=true.
Start the Action using the actions_start tool.
Poll for the Action status using the actions_get tool.
Read the Action result in the result field 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/start resource.
Use the payload schema, data from DataDoe, and other inputs to build your Action payload.
Validate the Action payload using the POST /actions resource with dryRun=true.
Start the Action using the POST /actions resource.
Poll for the Action status using the GET /actions/<action_id> resource.
Read the Action result in the result field 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 organisation,
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?

Amazon Seller Central and Vendor Central Actions

The following Actions are available for Amazon Seller Central and Vendor Central:

Action type	Operation	Available for	Max. items (API/MCP)	Action description	Result data
`AMAZON_LISTINGS_UPDATE`	Write	Sellers and Vendors	5000/50	Update Amazon listing parameters, including name, bullet points, keywords, and images. Sellers can also update price.	Confirmation that Amazon accepted the Action.
`AMAZON_LISTINGS_FIND`	Read	Sellers and Vendors	5000/300	Find Amazon listings by given identifier (like SKU, ASIN, or UPC).	Full models of found listings.
`AMAZON_LISTINGS_FEES_ESTIMATE`	Read	Sellers only	2500/300	Estimate Amazon listing fees for ASINs or SKUs at a given listing and shipping price.	Estimated fee breakdown per item.
`AMAZON_ORDERS_CANCEL`	Write	Sellers only	5000/50	Cancel an Amazon order item with a given cancellation reason.	Confirmation that Amazon accepted the Action.
`AMAZON_ORDERS_CONFIRM_SHIPMENT`	Write	Sellers only	5000/50	Confirm shipment for an Amazon order item and upload tracking information.	Confirmation that Amazon accepted the Action.
`AMAZON_ORDERS_SOLICITATION_FEEDBACK_SEND`	Write	Sellers only	300/300	Send a product review and seller feedback solicitation for an Amazon order.	Confirmation that Amazon accepted the Action.

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	Operation	Available for	Max. items (API/MCP)	Action description	Result data
`AMAZON_ADS_CAMPAIGNS_ADD`	Write	Sellers and Vendors	250/25	Add Amazon Ads campaigns	Created campaign entities.
`AMAZON_ADS_CAMPAIGNS_UPDATE`	Write	Sellers and Vendors	250/25	Update Amazon Ads campaigns	Full model of updated campaigns.
`AMAZON_ADS_CAMPAIGNS_REMOVE`	Write	Sellers and Vendors	250/25	Remove Amazon Ads campaigns	Empty response.
`AMAZON_ADS_CAMPAIGNS_FIND`	Read	Sellers and Vendors	-	Find Amazon Ads campaigns	Full model of found campaigns.
`AMAZON_ADS_AD_GROUPS_ADD`	Write	Sellers and Vendors	250/25	Add Amazon Ads ad groups	Created ad group entities.
`AMAZON_ADS_AD_GROUPS_UPDATE`	Write	Sellers and Vendors	250/25	Update Amazon Ads ad groups	Full model of updated ad groups.
`AMAZON_ADS_AD_GROUPS_REMOVE`	Write	Sellers and Vendors	250/25	Remove Amazon Ads ad groups	Empty response.
`AMAZON_ADS_AD_GROUPS_FIND`	Read	Sellers and Vendors	-	Find Amazon Ads ad groups	Full model of found ad groups.
`AMAZON_ADS_TARGETS_ADD`	Write	Sellers and Vendors	250/25	Add Amazon Ads targets	Created target entities.
`AMAZON_ADS_TARGETS_UPDATE`	Write	Sellers and Vendors	250/25	Update Amazon Ads targets	Full model of updated targets.
`AMAZON_ADS_TARGETS_REMOVE`	Write	Sellers and Vendors	250/25	Remove Amazon Ads targets	Empty response.
`AMAZON_ADS_TARGETS_FIND`	Read	Sellers and Vendors	-	Find Amazon Ads targets	Full model of found targets.
`AMAZON_ADS_ADS_ADD`	Write	Sellers and Vendors	250/25	Add Amazon Ads ads	Created ad entities.
`AMAZON_ADS_ADS_UPDATE`	Write	Sellers and Vendors	250/25	Update Amazon Ads ads	Full model of updated ads.
`AMAZON_ADS_ADS_REMOVE`	Write	Sellers and Vendors	250/25	Remove Amazon Ads ads	Empty response.
`AMAZON_ADS_ADS_FIND`	Read	Sellers and Vendors	-	Find Amazon Ads ads	Full model of found ads.
`AMAZON_ADS_AD_ASSOCIATIONS_ADD`	Write	Sellers and Vendors	250/25	Add Amazon Ads ad associations	Created ad association entities.
`AMAZON_ADS_AD_ASSOCIATIONS_UPDATE`	Write	Sellers and Vendors	250/25	Update Amazon Ads ad associations	Full model of updated ad associations.
`AMAZON_ADS_AD_ASSOCIATIONS_REMOVE`	Write	Sellers and Vendors	250/25	Remove Amazon Ads ad associations	Empty response.
`AMAZON_ADS_AD_ASSOCIATIONS_FIND`	Read	Sellers and Vendors	-	Find Amazon Ads ad associations	Full model of found ad associations.
`AMAZON_ADS_PORTFOLIOS_ADD`	Write	Sellers and Vendors	250/25	Add Amazon Ads portfolios	Created portfolio entities.
`AMAZON_ADS_PORTFOLIOS_UPDATE`	Write	Sellers and Vendors	250/25	Update Amazon Ads portfolios	Full model of updated portfolios.
`AMAZON_ADS_PORTFOLIOS_FIND`	Read	Sellers and 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.

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.