---
title: "Create Telegram integration"
method: POST
path: "/integration/telegram/create"
tags: ["Telegram Integration"]
---

# Create Telegram integration

`POST /integration/telegram/create`

## Request

- Base URL: `https://api.chatbotkit.com/api/v1`
- URL: `https://api.chatbotkit.com/api/v1/integration/telegram/create`
- Auth: HTTP bearer

## Request body

- object: A bot configuration that can be applied without a dedicated bot instance.
  - `alias` string, nullable: The unique alias for the instance
  - `name` string: The associated name
  - `description` string: The associated description
  - `meta` Meta: Meta data information
  - `blueprintId` string, nullable: The ID of the blueprint
  - `botId` string, nullable: The ID of the bot this configuration is using
  - `botToken` string: The Telegram integration bot token
  - `contactCollection` boolean: Weather to collect contacts
  - `sessionDuration` number: The session duration (in milliseconds)
  - `attachments` boolean: Weather the bot supports attachments
  - `allowFrom` string: Newline-or-comma-separated list of allowed senders. Use @username or @numericId for users,

## Response `200`

The Telegram integration was created successfully

- object
  - `id` string, required: The ID of the Telegram Integration

## Other responses

- `default`: An error response

---

[API](https://skmtc.dev/chatbotkit/apis/cbk-api.md) · [All operations](https://skmtc.dev/chatbotkit/apis/cbk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatbotkit/apis/cbk-api/revisions/13d250576136?raw)