Every request to the Marketplace API carries a token. You create tokens yourself in the Admin portal: there is no client id or secret to manage, only the token.Who can manage tokens#
The API token management page is shown to users whose role has the Admin Tools permission:View shows the page and lets the user copy any token on it.
Edit also lets the user create, rename, deactivate and delete tokens.
Anyone with either can copy every token on the page, so give Admin Tools only to the people who look after your integrations.Create a token#
1.
Sign in to the Admin portal for the company the integration will use. A token works only in the company it was created in.
2.
Open Admin tools in the menu, then API token management under System.
3.
Select Create new token. 
4.
Enter a Description that names the integration and who owns it, for example "ERP order export – IT team", and select Generate API token. 
5.
Copy the token from the New API token generated dialog with the copy button. 
6.
Store it in your integration's secrets store, such as a key vault or your platform's encrypted settings. Never put it in source code.
The token can be copied again later from the API token column of the list, so a lost copy doesn't mean a new token.Make a first call#
Send the token in the Authorization header of every request:A working token answers 200 with the first vendor:{
"pagination": {
"endCursor": "MA==",
"startCursor": "MA==",
"hasNextPage": true,
"hasPreviousPage": false,
"totalRecords": 431,
"resultsPerPage": 1
},
"items": [
{ "id": "50876", "name": "MISS LOS LLC", "status": "ACTIVE" }
]
}
A 401 means the token is missing, mistyped, expired, deactivated or deleted. Check that the header reads Bearer, a space, then the whole token.Keep a token working#
A token lasts 365 days. The Expiration date column shows when it ends, and its Status shows Expired after that. Create the replacement, switch your integration to it, then delete the old one.
Use one token per integration, so you can stop one without breaking the others.
A token belongs to one company. A test company and your live company each need their own.
Stop a token#
Deactivate it to stop it working for now: select the token's description, set API token status to Inactive, and select Update details. Set it back to Active to use it again.
Delete it to revoke it for good: select the bin icon on its row, then Delete API token. It can't be restored.

Either takes effect from the next request.If a token leaks, delete it straight away, create a new one, and switch your integration to it. The token's Last used date shows whether it was used after it leaked; it is updated about once an hour while the token is in use.Never send a token by email, in a chat or in a support ticket. Modified at 2026-11-17 01:58:13