Updated October 18, 2026

REST API

Call the workspace from your own server

On Team and above, Klientr answers JSON at /api/v1. Send Authorization Bearer and a token that starts with kl_. The response follows that teammate's role.

Starter leaves the API off. Team, Business, and Studio include it. Create the token in settings. It is shown once.

On this page

The same work the agent app already does

A token for the account

Each token belongs to one teammate. Calls can read or change only what that role allows, and only in the projects they can open.

One project when you have several

Send X-Project-Id, or project_id, when the token can see more than one project. The call then stays in that project.

Inbox, bookings, and the rest

Contacts, conversations, replies, tasks, bookings, services, articles, the FAQ bot, feedback, campaigns, social mentions, teammates, and project settings.

How it works

From a token to the first call

Create a token

On Team or above, open settings and create an API token. Copy it then. It is not shown again.

Call /api/v1

Send HTTPS JSON with Authorization Bearer and the kl_ token. Add X-Project-Id when the workspace has more than one project.

Read the reference

The API docs page lists every path, with the request and the response. The same page is linked from the site footer.

REST API Swagger documentation
In the workspace

What the API covers

  • Bearer tokens that start with kl_
  • Contacts, conversations, messages, tasks, and bookings
  • Articles, the FAQ bot, feedback, campaigns, and mentions
  • Team, Business, and Studio
FAQ

Common questions

Send Authorization Bearer and a token that starts with kl_. Create it in settings. The token is shown once, and later calls use that same value.

Team, Business, and Studio. Starter does not include API tokens. A token follows the teammate's role and the projects they can open.

The agent workspace, including contacts, the inbox, tasks, bookings, articles, feedback, campaigns, and social mentions. Connecting a channel and paying for a plan stay on the site.

Give every customer one place to land

Create a free workspace, connect a channel, and keep the reply, the booking, and the follow-up together.

No credit card · Your workspace, your data · Invite the team later

Sign in Start free