## 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](https://forms.clickup.com/9015200219/f/8cnj2ev-38615/AOYF9I35QFOXWJQXIG?type=Form&source=hub-actions-docs-beta) to get access.

## How to run an Action

### Using MCP

1. Connect DataDoe to [Claude](/hub/docs/datadoe-mcp/claude), [ChatGPT](/hub/docs/datadoe-mcp/chatgpt), or [another MCP-capable agent](/hub/docs/datadoe-mcp/overview).
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](/hub/docs/datadoe-features/actions.md) into your coding AI agent and ask it to generate the code for you.

1. Set up [your DataDoe API connection](/hub/docs/datadoe-api/how-to-connect).
2. Check the payload schema for the Action type you want to run in the [request body schema](https://api.datadoe.com/api/v1/docs#/Actions/ActionsApiController_startAction) 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](https://api.datadoe.com/api/v1/docs/json).

## What Actions are available?

### Amazon Seller Central Actions

The following Actions are available for Amazon Seller Central:

| Action Type                      | Description                            |
| -------------------------------- | -------------------------------------- |
| `AMAZON_LISTINGS_UPDATE`         | Update an Amazon listing               |
| `AMAZON_ORDERS_CANCEL`           | Cancel an Amazon order                 |
| `AMAZON_ORDERS_CONFIRM_SHIPMENT` | Confirm a shipment for an Amazon order |

### Amazon Ads Actions

> Amazon Ads Actions follow the structure shown in the [Amazon Ads API documentation](https://advertising.amazon.com/API/docs/en-us/guides/campaign-management/entities/overview#entity-relationships).

The following Actions are available for Amazon Ads:

| Action Type                         | Description                       |
| ----------------------------------- | --------------------------------- |
| `AMAZON_ADS_CAMPAIGNS_ADD`          | Add Amazon Ads campaigns          |
| `AMAZON_ADS_CAMPAIGNS_UPDATE`       | Update Amazon Ads campaigns       |
| `AMAZON_ADS_CAMPAIGNS_REMOVE`       | Remove Amazon Ads campaigns       |
| `AMAZON_ADS_AD_GROUPS_ADD`          | Add Amazon Ads ad groups          |
| `AMAZON_ADS_AD_GROUPS_UPDATE`       | Update Amazon Ads ad groups       |
| `AMAZON_ADS_AD_GROUPS_REMOVE`       | Remove Amazon Ads ad groups       |
| `AMAZON_ADS_TARGETS_ADD`            | Add Amazon Ads targets            |
| `AMAZON_ADS_TARGETS_UPDATE`         | Update Amazon Ads targets         |
| `AMAZON_ADS_TARGETS_REMOVE`         | Remove Amazon Ads targets         |
| `AMAZON_ADS_ADS_ADD`                | Add Amazon Ads ads                |
| `AMAZON_ADS_ADS_UPDATE`             | Update Amazon Ads ads             |
| `AMAZON_ADS_ADS_REMOVE`             | Remove Amazon Ads ads             |
| `AMAZON_ADS_AD_ASSOCIATIONS_ADD`    | Add Amazon Ads ad associations    |
| `AMAZON_ADS_AD_ASSOCIATIONS_UPDATE` | Update Amazon Ads ad associations |
| `AMAZON_ADS_AD_ASSOCIATIONS_REMOVE` | Remove 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](https://forms.clickup.com/9015200219/f/8cnj2ev-38615/AOYF9I35QFOXWJQXIG?type=Form&source=hub-actions-docs).