API integration

Drive the platform from your own system

Everything you do in the dashboard is available over REST: build an audience, update a script, launch a campaign, pull the statistics and the conversations. The key is issued in the dashboard and permissions are ticked per section — your CRM, n8n or backend gets exactly what you allowed.

API access is included with the account rental — there is nothing extra to pay for it.

What the API covers

Not a separate, cut-down interface but the same platform sections you see in the dashboard. API integration is for cases where campaigns have to be created from your system and the result has to come back into it.

Audiences

Create a list, import contacts, queue a chat-parsing task, read the collected people and their variable values. The task status while collection runs comes from here too.

Scripts

Read a dialogue script and its steps, create a new one or edit an existing one. Useful when the texts live on your side and have to reach the platform automatically.

Campaigns

Create a campaign, tie it to an audience, a script and accounts, start and stop it. Plus daily statistics, run history and a per-contact report.

Conversations

Lists of threads and the contents of a specific conversation with its status and conversions — so leads and their context end up in your CRM, not only in the dashboard.

Accounts

The state of your rented accounts: what is ready, what is being prepared, what is under a restriction. Handy when volume is planned on your side.

Wallet

Balance and operation history. Needed if you track spending from your own system or resell volume to clients.

You tick the permissions yourself

A key has no “everything allowed by default” mode. Permissions are granted per section and separately for reading and writing — an integration gets exactly the slice it needs.

You can issue as many keys as you like: one for the CRM, one for an n8n scenario, one for a contractor. Any of them is revoked in the dashboard and access disappears at once — the other integrations keep working.

campaigns:read campaigns:write flows:read flows:write audience:read audience:write accounts:read accounts:actions wallet:read

What people usually need it for

The four setups people most often come to the API for.

Leads straight into the CRM

The moment the right conversion appears in a conversation, your backend pulls the thread and the contact and opens a deal — no manual transfer, no “we forgot to export”.

Campaigns from your system

A new client list lands in your database — a campaign launches. The platform is the executor here; the decision belongs to your process.

Scripts from your repository

Texts and branches live on your side and reach the platform automatically. An edit is made once — in your repository.

Reporting next to your other channels

Daily statistics and run history go into BI, where Telegram sits alongside ads and email — and is measured by the same rules.

Three ways to drive the platform

Pick by who makes the calls: a person, an AI agent or your code.

The dashboard — all the same things by hand, if you do not need an integration.
MCP server — connect the platform to Claude or ChatGPT and give tasks in words. Same key, same permissions.
The REST API — when the platform has to be embedded into another process and that process, not a person, makes the calls.

All three share the same permissions: what the key forbids, neither the agent nor a script will do.

How to connect

No separate developer sign-up is needed — the key is issued in the same dashboard.

01
Issue a key

The API section of the dashboard. One key per integration — that way revoking it later costs you nothing.

02
Tick the permissions

Only the sections this integration needs, and read-only if it has no business writing.

03
Send it in a header

The key travels in the Authorization header as an ordinary Bearer token. No request signing, no certificate exchange.

04
Call the methods

From a CRM, from n8n, from your own backend — anywhere an HTTP request can be sent.

What is next door

The API drives the platform. The Telegram actions themselves, and working in plain words, live in the neighbouring sections.

Common questions about the API

There is no separate charge — the API is included with the account rental. You pay for the same things as in the dashboard: account work and AI calls.
Here you drive the platform: audiences, scripts, campaigns, reports. The Userbot API sits a floor below: it drives the Telegram account itself, to collect chat members or write to a specific person. That one needs a separate permission, accounts:actions.
Yes, and it is the better way: one key for the CRM, one for automation, one for a contractor. Each has its own permission set and any of them is revoked separately without touching the others.
The request is rejected rather than half-executed. Permissions are checked on every method, so a read-only key cannot change anything even by accident.
No, it is the same key — the MCP server talks to the platform with it and obeys the same permissions. The only difference is who calls the methods: your code or an AI agent.
The platform speaks plain REST, so the standard HTTP node does the job: key in the header, method URL, request body. No special plugin to install.

Embed the platform into your process

Issue a key in the dashboard and make your first call. API access comes with the account rental — from $90 a month.