Tokens are keys generated on the Kondado platform that allow programmatic interaction of other applications with our APIs and Webhooks.
With token access, your applications can:
- Create and edit sources, destinations, pipelines, and models;
- Trigger pipelines;
- Receive data in your destination via webhooks.
The flexibility of these applications comes with the same level of security offered by our platform.
See below how to interact with your tokens:
Accessing the Tokens Page
1) Once logged in, click on your email (top-right menu) and then on "Settings":
2) On the settings page, locate the "Tokens" section:
3) You will see the tokens page, where you can create, activate, or deactivate existing tokens. Tokens are linked to the user who created them. On this page, there are two (2) types of tokens: those related to the Via Kondado destination ("Via Kondado Tokens") and those created by users (listed under "Tokens", next to the "CREATE +" button):
Creating New Tokens
4) To create new tokens, click on "CREATE +":
5) In the text box that opens, type a description for the token and click "OK". We recommend that this description relates to the token's purpose (e.g., to receive leads from RDStation) and that you use one token for each different application. Currently, there is no limit to the number of tokens you can have in an account:
6) After clicking "OK", our platform will generate your token. It consists of two parts:
- Token Key: Analogous to a username used to log into a website, the token key acts as the username.
- Token: This information is similar to a password and will only be displayed at the time of creation. Store it in a safe place (or directly in the application interacting with Kondado).
After noting the token, click "OK":
7) Done! Your new token has been created:
Managing Your Tokens
8) Once you have tokens created, you can activate or deactivate them at any time by toggling the switches on the right. Deactivating a token will render it inaccessible:
We recommend periodically “rotating” your tokens. To do this, deactivate an old token, create a new one, and replace the old token in your application.
Create and Manage Access Tokens on Kondado
Generate, secure, and maintain API tokens for programmatic access to Kondado's pipelines, sources, destinations, and webhooks.
Access your account settings
Log in to the Kondado platform, click your email address in the top-right menu, and select "Settings" to reach the configuration area.
Navigate to the Tokens section
On the settings page, find the "Tokens" section to view existing tokens ("Via Kondado Tokens" and user-created tokens) and access the creation tools.
Create a new token
Click "CREATE +", enter a description tied to the token's purpose (for example, "Receive leads from RD Station"), and click "OK". Use one token per application so you can rotate or revoke them independently.
Securely store the Token Key and Token
Copy the Token Key (used as the username) and the Token (used as the password). The Token is shown only at creation time - store it in your application or a password manager before clicking "OK". If lost, you must create a new token.
Activate or deactivate tokens as needed
Toggle the switch next to a token to activate or deactivate it. Deactivating a token blocks any application using it from interacting with the Kondado APIs and webhooks, without affecting other tokens.
Rotate tokens periodically
Deactivate old tokens, create replacements with clear descriptions, and update the credentials in your application. Rotating tokens limits exposure if a token is ever compromised.
