---
title: "Request a Telegram destination for this workspace. An agent can never finalise pairing: this returns connect_url for the human owner/admin to open (they authenticate, receive a single-use Telegram link, and return here). Never returns a pairing token."
method: POST
path: "/workspace/channels/telegram/pair"
---

# Request a Telegram destination for this workspace. An agent can never finalise pairing: this returns connect_url for the human owner/admin to open (they authenticate, receive a single-use Telegram link, and return here). Never returns a pairing token.

`POST /workspace/channels/telegram/pair`

## Request

- Base URL: `https://forbiz.io/api/public/agent`
- URL: `https://forbiz.io/api/public/agent/workspace/channels/telegram/pair`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string

## Response `200`

A destination is already active

- object
  - `ok` boolean
  - `already_active` boolean
  - `connect_url` string
  - `channel_id` string

## Other responses

- `202`: Human authorization required
- `208`: Idempotent replay of a previous request with the same Idempotency-Key. Nothing was applied again.
- `503`: Telegram is not configured on this deployment

---

[API](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api.md) · [All operations](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api/revisions/e5b10d59dc5f?raw)