Skip to main content
TroopyDocs
GuidesSet up and use TroopyAppsConnect your servicesAPIThe API, the CLI and MCPChangelogEach update to Troopy

Developers

Account

Troop

Skills

Tasks and projects

Needs you

Routines and triggers

Brain

Docs

Canvas

Email

CRM

Outreach

Customers

Analytics

Sessions

Surveys

Support Agent

Tests and incidents

Disputes

Apps

Vault

Computer

Open Troopy
Troopy

API reference / Account

Link your Telegram

A one-time link to Troopy's bot, good for 10 minutes: the Telegram account that opens it and presses Start is linked to you in this workspace, and unlinked from anywhere else. It then talks to teammates and decides approvals as you, so this needs a key with every scope.

post/api/v1/me/telegram

Authorization

HeaderAuthorization: Bearer <API key>
Or the headerX-API-Key: <API key>
API keyMake one in Troopy under Settings > API keys. It acts as you, in its workspace.
Scopesworkspace:readworkspace:writeorganization:writebrain:readbrain:writeagents:readagents:writeapps:readapps:writetasks:readtasks:writecode:writeresearch:readresearch:writetests:readtests:writeincidents:readincidents:writeanalytics:readanalytics:writecrm:readcrm:writecustomers:readcustomers:writevault:readvault:writeoutreach:readoutreach:writesessions:readsessions:writesupport:readsupport:writedisputes:write

Other ways to call it

CLItroopy telegram connect
MCP toolNone. Call it over REST or with the CLI.
Rate limit10 calls in 60 seconds, for each key

Response

200 · application/json
data*object
9 properties
available*boolean

Whether this Troopy has a Telegram bot set up

bot*string | null

The bot's Telegram username

linked*boolean

Whether your Telegram is linked to this workspace

username*string | null

The linked Telegram account's username, if it has one

linkedAt*string | null
workspaceBot*object | null

The workspace's own bot, named after its lead, once someone made it: people talk to the Chief of Staff there

4 properties
username*string

Its Telegram username

disabled*string | null

Why it stopped answering, or null

canOpen*boolean

Whether Telegram lets you open it: its owner and the first 10 others who connected Telegram here

createdAt*string

ISO 8601 date and time

createBotUrl*string | null

Opens Telegram's create-bot screen, filled in with the lead's name: for owners and admins with Telegram linked, while the workspace has no bot

url*string

Open it in Telegram

expiresAt*string

ISO 8601 date and time

Errors

401 unauthorizedSend an API key as `Authorization: Bearer tr_live_...`. Create one in Troopy under Settings.
403 forbiddenThe key lacks a scope this operation needs, or its owner lacks the role. detail says which; create a key with the scope, or ask an organization owner or admin.
429 rate_limitedWait the number of seconds in Retry-After, then retry.