> 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`.
> Data Scheme (Markdown index, one page per table): https://api.datadoe.com/api/v1/spec/data-scheme.md. Full 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/Connecting Accounts: `https://www.datadoe.com/hub/docs/basics/connecting-accounts.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 and 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/Initial Loads: `https://www.datadoe.com/hub/docs/datadoe-data/initial-loads.md`
> - DataDoe Data/Managing Data Tables: `https://www.datadoe.com/hub/docs/datadoe-data/managing-data-tables.md`
> - DataDoe Data/Migrating from SellerBoard: `https://www.datadoe.com/hub/docs/datadoe-data/migrating-from-sellerboard.md`
> - DataDoe Data/SAT migration to profit tables: `https://www.datadoe.com/hub/docs/datadoe-data/sat-migration-to-profit-tables.md`
> - DataDoe Data/SQP Data: `https://www.datadoe.com/hub/docs/datadoe-data/search-query-performance.md`
> - DataDoe Data/Timezones: `https://www.datadoe.com/hub/docs/datadoe-data/orders-purchase-date-timezones.md`
> - DataDoe Data/Uploading COGS: `https://www.datadoe.com/hub/docs/datadoe-data/uploading-cogs.md`
> - DataDoe Data/Uploading Vendor Codes: `https://www.datadoe.com/hub/docs/datadoe-data/uploading-vendor-codes.md`
> - DataDoe Features/Actions: `https://www.datadoe.com/hub/docs/datadoe-features/actions.md`
> - DataDoe Features/Actions - Manage Images: `https://www.datadoe.com/hub/docs/datadoe-features/actions-manage-images.md`
> - DataDoe Features/Amazon Marketing Cloud: `https://www.datadoe.com/hub/docs/datadoe-features/amc.md`
> - DataDoe Features/AMC query templates: `https://www.datadoe.com/hub/docs/datadoe-features/amc-query-templates.md`
> - DataDoe Features/Features Overview: `https://www.datadoe.com/hub/docs/datadoe-features/overview.md`
> - DataDoe Features/Files: `https://www.datadoe.com/hub/docs/datadoe-features/files.md`
> - DataDoe Features/Plugins: `https://www.datadoe.com/hub/docs/datadoe-features/plugins.md`
> - DataDoe Features/Usage Logs: `https://www.datadoe.com/hub/docs/datadoe-features/usage-logs.md`
> - DataDoe Features/Webhooks: `https://www.datadoe.com/hub/docs/datadoe-features/webhooks.md`
> - DataDoe Features/White label: `https://www.datadoe.com/hub/docs/datadoe-features/white-label.md`
> - DataDoe MCP/Overview: `https://www.datadoe.com/hub/docs/datadoe-mcp/overview.md`
> - DataDoe MCP/Using Antigravity: `https://www.datadoe.com/hub/docs/datadoe-mcp/antigravity.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 Codex Sites: `https://www.datadoe.com/hub/docs/datadoe-mcp/codex-sites.md`
> - DataDoe MCP/Using CrewAI: `https://www.datadoe.com/hub/docs/datadoe-mcp/crewai.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 Glama MCP Inspector: `https://www.datadoe.com/hub/docs/datadoe-mcp/glama.md`
> - DataDoe MCP/Using Grok: `https://www.datadoe.com/hub/docs/datadoe-mcp/grok.md`
> - DataDoe MCP/Using GrokBot: `https://www.datadoe.com/hub/docs/datadoe-mcp/grokbot.md`
> - DataDoe MCP/Using Gumloop: `https://www.datadoe.com/hub/docs/datadoe-mcp/gumloop.md`
> - DataDoe MCP/Using Hermes Agent: `https://www.datadoe.com/hub/docs/datadoe-mcp/hermes.md`
> - DataDoe MCP/Using Littlebird: `https://www.datadoe.com/hub/docs/datadoe-mcp/littlebird.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 OpenCode: `https://www.datadoe.com/hub/docs/datadoe-mcp/opencode.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/Build with Codex: `https://www.datadoe.com/hub/docs/datadoe-api/codex.md`
> - DataDoe API/How to connect to the API: `https://www.datadoe.com/hub/docs/datadoe-api/how-to-connect.md`
> - DataDoe API/Invitation links API: `https://www.datadoe.com/hub/docs/datadoe-api/invitation-links.md`
> - DataDoe API/Vibe code with Claude Code: `https://www.datadoe.com/hub/docs/datadoe-api/claude-code.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.

# How to manage sellers and vendors with the API

Use the DataDoe public API to list, inspect, rename, reconnect, and delete the sellers and vendors in your Organization. DataDoe MCP offers the same operations except deletion. Send every API request with your `datadoe-api-key` header. To add a seller or vendor, create an invitation with the [Invitation links API](/hub/docs/datadoe-api/invitation-links).

## List and inspect sellers and vendors

- `GET /api/v1/util/sellers-and-vendors` lists sellers and vendors. Filter with `query` (name search) and `marketplaceCountryCode`, and page with `page` and `pageSize`.
- `GET /api/v1/util/sellers-and-vendors/{sellerOrVendorId}` returns one seller or vendor in the same shape as a list item.

Each seller or vendor includes its `id`, `name`, `accountType`, marketplace, row count, and its Seller Central, Vendor Central, Amazon Ads, and Amazon Ads DSP connections. Each connection includes:

- `needsReauthorization`: `true` when Amazon no longer accepts the stored authorization and data stops updating
- `lastAuthorizedAt`: when Amazon last granted the authorization
- `initialLoadStage`: how far the first data load has progressed

The `sellerOrVendorId` applies to one marketplace. Use it in exports, Actions, and the other API endpoints.

## Rename a seller or vendor

Send a `PATCH` request to `/api/v1/util/sellers-and-vendors/{sellerOrVendorId}`:

```json
{
    "name": "Partner ABC US"
}
```

The API returns status `200` with the updated seller or vendor. Names are unique within your Organization, so a name that another seller or vendor uses returns status `409`.

## Reconnect a seller or vendor

When a connection shows `needsReauthorization: true`, create a reconnect invitation with `POST /api/v1/util/sellers-and-vendors/{sellerOrVendorId}/reconnect` and send it to the account owner. The seller or vendor keeps its ID and data. See [Reconnect an existing seller or vendor](/hub/docs/datadoe-api/invitation-links#reconnect-an-existing-seller-or-vendor).

## Delete a seller or vendor

Send a `DELETE` request to `/api/v1/util/sellers-and-vendors/{sellerOrVendorId}`. The API returns status `204`.

- Deletion is immediate and cannot be undone.
- DataDoe also deletes the seller or vendor’s connections. A connection that another seller or vendor still uses, such as a shared Amazon Ads connection, is kept.
- Data collected for deleted connections is purged after 30 days.
- The API returns status `409` while the seller or vendor has an Amazon Marketing Cloud (AMC) binding. Disconnect AMC first. See [How do I disconnect AMC?](/hub/docs/datadoe-features/amc#how-do-i-disconnect-amc).

To add the account again later, create a new invitation. The new seller or vendor gets a new ID.

## MCP tools

DataDoe MCP offers the same operations except deletion. Delete sellers and vendors through the API or in DataDoe.

| Operation                                       | MCP tool                                |
| ----------------------------------------------- | --------------------------------------- |
| List sellers and vendors                        | `sellers_and_vendors_list`              |
| Inspect one seller or vendor                    | `sellers_and_vendors_get`               |
| Rename                                          | `sellers_and_vendors_rename`            |
| Create an invitation or a reconnect invitation  | `sellers_and_vendors_invitation_create` |
| List pending invitations or read one invitation | `sellers_and_vendors_invitations_get`   |
| Revoke an invitation                            | `sellers_and_vendors_invitation_revoke` |

`sellers_and_vendors_invitation_create` creates a reconnect invitation when it gets a `sellerOrVendorId`. `sellers_and_vendors_invitations_get` returns one invitation and its status when it gets an `invitationId`, and lists pending invitations otherwise. In MCP, `redirectUrl` is optional when creating invitations. Without it, the invitee sees the DataDoe confirmation page when the flow finishes.

## Errors

- `400`: the ID is not a UUID, or the request body is invalid
- `404`: the seller or vendor does not exist in your Organization
- `409`: see the conflicts above