Skip to main content
DataDoe HubHub
(opens in a new tab)
ChatGPT (opens in a new tab)
Claude (opens in a new tab)

What are DataDoe Actions?

Actions let you manipulate your Amazon data using DataDoe MCP or the API.

Actions are available in a closed beta for selected organizations.

Please contact us (opens in a new tab) to get access.

How to run an Action

Using MCP

  1. Connect DataDoe to Claude, ChatGPT, or another MCP-capable agent.
  2. Get the payload schema for the Action type you want to run using the actions_details_schema_get tool.
  3. Use the payload schema, data from DataDoe, and other inputs to build your Action payload.
  4. Validate the Action payload using the actions_start tool with dryRun=true.
  5. Start the Action using the actions_start tool.
  6. Poll for the Action status using the actions_get tool.

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.

  1. Set up your DataDoe API connection.
  2. 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.
  3. Use the payload schema, data from DataDoe, and other inputs to build your Action payload.
  4. Validate the Action payload using the POST /actions resource with dryRun=true.
  5. Start the Action using the POST /actions resource.
  6. Poll for the Action status using the GET /actions/<action_id> resource.

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 Actions are available?

Amazon Seller Central Actions

The following Actions are available for Amazon Seller Central:

Action TypeDescription
AMAZON_LISTINGS_UPDATEUpdate an Amazon listing
AMAZON_ORDERS_CANCELCancel an Amazon order
AMAZON_ORDERS_CONFIRM_SHIPMENTConfirm a shipment for an Amazon order

Amazon Ads Actions

Amazon Ads Actions follow the structure shown in the Amazon Ads API documentation (opens in a new tab).

The following Actions are available for Amazon Ads:

Action TypeDescription
AMAZON_ADS_CAMPAIGNS_ADDAdd Amazon Ads campaigns
AMAZON_ADS_CAMPAIGNS_UPDATEUpdate Amazon Ads campaigns
AMAZON_ADS_CAMPAIGNS_REMOVERemove Amazon Ads campaigns
AMAZON_ADS_AD_GROUPS_ADDAdd Amazon Ads ad groups
AMAZON_ADS_AD_GROUPS_UPDATEUpdate Amazon Ads ad groups
AMAZON_ADS_AD_GROUPS_REMOVERemove Amazon Ads ad groups
AMAZON_ADS_TARGETS_ADDAdd Amazon Ads targets
AMAZON_ADS_TARGETS_UPDATEUpdate Amazon Ads targets
AMAZON_ADS_TARGETS_REMOVERemove Amazon Ads targets
AMAZON_ADS_ADS_ADDAdd Amazon Ads ads
AMAZON_ADS_ADS_UPDATEUpdate Amazon Ads ads
AMAZON_ADS_ADS_REMOVERemove Amazon Ads ads
AMAZON_ADS_AD_ASSOCIATIONS_ADDAdd Amazon Ads ad associations
AMAZON_ADS_AD_ASSOCIATIONS_UPDATEUpdate Amazon Ads ad associations
AMAZON_ADS_AD_ASSOCIATIONS_REMOVERemove Amazon Ads ad associations

How long does it take to complete an Action?

DataDoe executes the Action on Amazon immediately. For Seller Central changes, it may take between 5 minutes and a few hours for Amazon to process the Action. Amazon Ads typically processes changes in less than 15 minutes.

What is the cost of running an Action?

Base cost of running an Action is 2 AI tokens no matter the Action type. This allows for sending updates of up to 100 entities at a time. Each additional 100 entities costs 1 additional AI token.

For example, updating 15 listings using the AMAZON_LISTINGS_UPDATE Action costs 2 AI tokens. Updating 215 listings using the same Action costs 4 AI tokens.

Do you plan to add more Actions?

Yes. We are constantly adding new Actions to the platform. If you have a specific Action in mind, please let us know using the contact form (opens in a new tab).