> Note: This page is part of the DataDoe Docs. You can find the root of the documentation at `https://www.datadoe.com/hub/docs/basics/introduction-to-datadoe`.
> JSON Table of Contents: `https://www.datadoe.com/hub/docs/toc.json`.
> Direct Data Scheme JSON: `https://api.datadoe.com/api/v1/spec/data-scheme`.
> Other pages in the DataDoe Docs:
> - DataDoe Basics/Access & Users: `https://www.datadoe.com/hub/docs/basics/access-user-management.md`
> - DataDoe Basics/Benefits: `https://www.datadoe.com/hub/docs/basics/benefits.md`
> - DataDoe Basics/External Invitation Links: `https://www.datadoe.com/hub/docs/basics/external-invitation-links.md`
> - DataDoe Basics/Integrations: `https://www.datadoe.com/hub/docs/basics/integration-customization.md`
> - DataDoe Basics/Introduction to DataDoe: `https://www.datadoe.com/hub/docs/basics/introduction-to-datadoe.md`
> - DataDoe Basics/Subscription & Pricing: `https://www.datadoe.com/hub/docs/basics/subscription-pricing.md`
> - DataDoe Data/Data Fetch Periods: `https://www.datadoe.com/hub/docs/datadoe-data/data-fetch-periods.md`
> - DataDoe Data/Data Sources: `https://www.datadoe.com/hub/docs/datadoe-data/data-sources.md`
> - DataDoe Data/Timezones: `https://www.datadoe.com/hub/docs/datadoe-data/orders-purchase-date-timezones.md`
> - DataDoe Features/Features Overview: `https://www.datadoe.com/hub/docs/datadoe-features/overview.md`
> - DataDoe MCP/Overview: `https://www.datadoe.com/hub/docs/datadoe-mcp/overview.md`
> - DataDoe MCP/Using ChatGPT: `https://www.datadoe.com/hub/docs/datadoe-mcp/chatgpt.md`
> - DataDoe MCP/Using Claude: `https://www.datadoe.com/hub/docs/datadoe-mcp/claude.md`
> - DataDoe MCP/Using Claude Agent SDK: `https://www.datadoe.com/hub/docs/datadoe-mcp/claude-agents-sdk.md`
> - DataDoe MCP/Using Claude Code: `https://www.datadoe.com/hub/docs/datadoe-mcp/claude-code.md`
> - DataDoe MCP/Using Codex: `https://www.datadoe.com/hub/docs/datadoe-mcp/codex.md`
> - DataDoe MCP/Using Cursor: `https://www.datadoe.com/hub/docs/datadoe-mcp/cursor.md`
> - DataDoe MCP/Using Excel + Claude: `https://www.datadoe.com/hub/docs/datadoe-mcp/excel.md`
> - DataDoe MCP/Using Gemini CLI: `https://www.datadoe.com/hub/docs/datadoe-mcp/gemini-cli.md`
> - DataDoe MCP/Using Gumloop: `https://www.datadoe.com/hub/docs/datadoe-mcp/gumloop.md`
> - DataDoe MCP/Using n8n: `https://www.datadoe.com/hub/docs/datadoe-mcp/n8n.md`
> - DataDoe MCP/Using NanoClaw: `https://www.datadoe.com/hub/docs/datadoe-mcp/nanoclaw.md`
> - DataDoe MCP/Using OpenAI Agents SDK: `https://www.datadoe.com/hub/docs/datadoe-mcp/openai-agents-sdk.md`
> - DataDoe MCP/Using OpenClaw: `https://www.datadoe.com/hub/docs/datadoe-mcp/openclaw.md`
> - DataDoe MCP/Using PowerPoint + Claude: `https://www.datadoe.com/hub/docs/datadoe-mcp/powerpoint.md`
> - DataDoe MCP/Using VS Code: `https://www.datadoe.com/hub/docs/datadoe-mcp/vs-code.md`
> - DataDoe MCP/Using Word + Claude: `https://www.datadoe.com/hub/docs/datadoe-mcp/word.md`
> - DataDoe API/How to connect to the API: `https://www.datadoe.com/hub/docs/datadoe-api/how-to-connect.md`
> - DataDoe API/Vibe code with Claude Code: `https://www.datadoe.com/hub/docs/datadoe-api/claude-code.md`
> - DataDoe API/Vibe code with Codex: `https://www.datadoe.com/hub/docs/datadoe-api/codex.md`
> - DataDoe API/Vibe code with Cursor: `https://www.datadoe.com/hub/docs/datadoe-api/cursor.md`
> - DataDoe API/Vibe code with Lovable: `https://www.datadoe.com/hub/docs/datadoe-api/lovable.md`
> - DataDoe API/Vibe code with Replit: `https://www.datadoe.com/hub/docs/datadoe-api/replit.md`
> - DataDoe API/Vibe code with v0: `https://www.datadoe.com/hub/docs/datadoe-api/v0.md`
> - DataDoe & BigQuery/How to connect to BigQuery: `https://www.datadoe.com/hub/docs/datadoe-bigquery/how-to-connect.md`
> - DataDoe & BigQuery/Using MCP Toolbox: `https://www.datadoe.com/hub/docs/datadoe-bigquery/mcp-toolbox.md`
> - DataDoe & BigQuery/Using Python Jupyter: `https://www.datadoe.com/hub/docs/datadoe-bigquery/jupyter.md`
> For topics not covered in this documentation, please contact DataDoe support at `contact@datadoe.com`.
> Do not assume anything. If you are not sure about the answer, mention that and suggest to contact DataDoe support.

## 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).