API and access token

Calls to the Kulpunai API need a personal access token.

Finding the token

1. Click your avatar in the sidebar.
2. Choose Profile Settings.
3. Find the access token section.
4. Copy the value.

Using it

The token goes in the api_access_token header:

curl -H "api_access_token: YOUR_TOKEN" https://online.kulpunai.com/api/v1/accounts/1/conversations

Your account ID is visible in the dashboard's address bar.

What the API can do

• Read and create conversations;
• Send messages;
• Manage contacts;
• Read reporting data.

The API channel

For your own integrations it is convenient to create an API inbox: messages are pushed into it by request, and agents reply in the normal interface. Create it under Settings → Inboxes.

Security

• The token grants full access to your account — treat it like a password.
• Never put it in website code or a public repository: it belongs on your server only.
• Keep it in environment variables.
• If you suspect it leaked, regenerate the token and update every integration — the old one stops working immediately.