How to create invitation links with the API
This page covers the API. For what invitation links are and how to create them in the DataDoe UI, see External invitation links.
Use the DataDoe public API to create one-time Seller or Vendor invitation links from your application or automation. Send every request with your datadoe-api-key header. DataDoe MCP offers the same invitation operations; see MCP tools.
Create an invitation
Send a POST request to /api/v1/util/sellers-and-vendors/invite with this body:
1{
2 "name": "Partner ABC",
3 "tenantType": "SELLER",
4 "accessLevel": "READ_ONLY",
5 "redirectUrl": "https://example.com/datadoe/callback"
6}redirectUrl must use HTTPS and include a domain name. DataDoe rejects localhost, IP addresses, and hostnames without a domain suffix.
The API returns status 201:
1{
2 "id": "4f0f1c2e-…",
3 "invitationUrl": "https://app.datadoe.com/invitation/…",
4 "expiresAt": "2026-08-25T12:00:00.000Z"
5}Store id with the invitation in your application. The callback returns it as invitationId, and you can read the invitation status with it.
Open invitationUrl in a browser. The invitee completes the Seller Central or Vendor Central connection. Amazon Ads is optional and can be connected or skipped.
If white label is enabled, the invitation uses your Organization’s saved branding and legal links. With a production domain prefix, the returned link also uses your custom app hostname. Share the returned invitationUrl without changing its hostname. After changing or clearing the prefix, create new invitations and share their links.
Reconnect an existing seller or vendor
When Amazon stops accepting an account’s authorization, its connection shows needsReauthorization: true in the sellers and vendors API. Send a reconnect invitation to the account owner instead of deleting and adding the account again. The seller or vendor keeps its ID, data, settings, and access level.
Send a POST request to /api/v1/util/sellers-and-vendors/{sellerOrVendorId}/reconnect:
1{
2 "redirectUrl": "https://example.com/datadoe/callback"
3}name is optional. It defaults to Reconnect followed by the seller or vendor name. The API returns status 201 with the same id, invitationUrl, and expiresAt fields as a new invitation.
The invitee does not choose a marketplace. They sign in to Amazon and reauthorize:
- the Seller Central or Vendor Central connection
- then Amazon Ads, which is optional and can be skipped
For Ads-only accounts, the invitee reauthorizes Amazon Ads only. If the seller or vendor has no Amazon Ads connection, the invitee can connect one after Seller Central or Vendor Central. Amazon Ads DSP connections are not reauthorized.
The invitee must sign in with the Amazon account that owns the connection. Another account fails with RECONNECT_ACCOUNT_MISMATCH.
As with reconnecting in DataDoe, a failed attempt does not use up a reconnect invitation. The invitee can open the same link and try again until it succeeds or expires. Once Seller Central or Vendor Central is reauthorized, the invitation counts as COMPLETED, even if the optional Amazon Ads step fails.
The API returns status 409 when the seller or vendor has no Seller Central, Vendor Central, or Amazon Ads connection to reconnect.
Track and revoke invitations
GET /api/v1/util/sellers-and-vendors/invitationslists pending invitations, including reconnect invitations. UsepageandpageSize(maximum100) to page through them.GET /api/v1/util/sellers-and-vendors/invitations/{invitationId}returns one invitation and itsstatus.DELETE /api/v1/util/sellers-and-vendors/invitations/{invitationId}revokes a pending invitation and returns status204. It returns status409when the invitation was already used or has expired.
Each invitation includes:
type:CONNECTfor a new seller or vendor,RECONNECTfor an existing onestatus:PENDING,COMPLETED,FAILED, orEXPIREDtenantType:SELLER,VENDOR, orADS_ONLY(reconnect invitations for Ads-only accounts only)sellerOrVendorId: set on reconnect invitations, and on completed new invitationsinvitationUrl,redirectUrl,accessLevel,createdAt,expiresAt, andusedAt
A FAILED invitation cannot be used again. Create a new one. Reconnect invitations never become FAILED.
Use the invitation status to confirm the result when the callback does not arrive, for example when the invitee closes the browser. DataDoe removes used invitations after at least 24 hours and expired invitations once a day. After that, the API returns status 404.
Callback parameters
When the flow finishes, DataDoe redirects the browser to redirectUrl with status 302. The query string includes:
success:trueorfalseerror: empty on success, orSC_SELLING_PARTNER_ALREADY_AUTHORIZED,SC_ACCOUNT_LACKING_PERMISSIONS,ADS_NO_PROFILE_FOUND,CUSTOM_APP_NOT_CONFIGURED,RECONNECT_ACCOUNT_MISMATCH, orUNKNOWNsellerOrVendorIdsellerOrVendorNamesellerOrVendorMarketplaceCountryCodesellerOrVendorSellingPartnerIdinvitationIdinvitationType:CONNECTorRECONNECT
Seller and Vendor fields are empty when DataDoe cannot identify the account. Existing query parameters on your callback URL are preserved.
Invitation links are single-use and valid for 7 days.

