---
title: "Register this swarm's public Telegram webhook URL and secret token with the Bot API (setWebhook), then return getWebhookInfo."
method: POST
path: "/api/integrations/chat/telegram/register-webhook"
tags: ["Integrations"]
---

# Register this swarm's public Telegram webhook URL and secret token with the Bot API (setWebhook), then return getWebhookInfo.

`POST /api/integrations/chat/telegram/register-webhook`

## Request

- Base URL: `http://localhost:3013`
- URL: `http://localhost:3013/api/integrations/chat/telegram/register-webhook`
- Auth: HTTP bearer

## Request body

- object

## Response `200`

Webhook registered

- object
  - `webhookUrl` string, required
  - `webhookInfo` object, required
    - `url` string, required
    - `has_custom_certificate` boolean
    - `pending_update_count` number
    - `last_error_date` number
    - `last_error_message` string
    - `max_connections` number
    - `ip_address` string
    - `allowed_updates` string[]

## Other responses

- `400`: Telegram is not configured for webhook mode
- `403`: Only the lead agent or a dashboard user can register the webhook
- `502`: The Telegram Bot API rejected the call

## Changes

- **2026-10-15** `1f7e041b998a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/integrations/chat/telegram/register-webhook/post.md)

---

[API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) - [All operations](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/revisions/7e4c7198192a?raw)