To use Kolleno's Open API, you need an API key. You can create one yourself in Kolleno, so there is no need to contact support.
Create your key
Click on your name in the bottom left of the screen,
Choose Personal settings.
Select API keys.
Click Create API key. We email you a link straight away.
⚠️ The link shows your Client Secret once and expires after 24 hours. Save it somewhere secure before you close the page: we cannot show it to you again. If it is lost, delete the key and create another.
Use your key
A request carries both halves of the credential in one header:
Authorization: API CLIENT_ID:CLIENT_SECRET
The Client ID is shown on the key's card under Personal settings > API keys. The Client Secret appears only in the one-time link we email you.
Choose the right account
A key acts as the user who created it: the same permissions, the same companies, and every action it takes is recorded against that user.
For occasional or personal use, your own account is fine.
For an integration or anything automated, sign in as a dedicated user (for example
kollenoapi@mycompany.com) and create the key from that account. Automated actions then stay separate from a person's, and the key survives team changes.
Give that user the Admin role if the integration needs to create, read, update and delete.
Manage your keys
Personal settings > API keys lists every key you own, when it was created and how many requests it has made.
Switch a key off to pause it. It stops working straight away, and you can switch it back on whenever you need it.
Delete a key to revoke it for good. Anything using it stops working immediately, and the key cannot be restored.
You only see and manage your own keys. A colleague's keys are theirs alone.
Still need us?
Contact support@kolleno.com if you need an API-only account that nobody can sign into with a password. We set those up for you.