---
title: "Telegram bot webhook ingress"
method: POST
path: "/v1/webhooks/telegram/{connectionId}"
tags: ["Webhooks"]
---

# Telegram bot webhook ingress

`POST /v1/webhooks/telegram/{connectionId}`

Verifies Telegram's per-connection secret header, durably claims update_id, and acknowledges before queued worker processing begins.

## Path parameters

- `connectionId` string, required

## Response `200`

Telegram update accepted or already processed.

- TelegramWebhookResponse
  - `ok` true, required
  - `accepted` boolean, required
  - `reason` string

## Other responses

- `400` — Invalid Telegram update or connection id.
- `401` — Invalid Telegram webhook secret.
- `404` — Telegram connection not found.
- `413` — Telegram update body exceeds 256 KiB.

---

[API](https://skmtc.net/openworklabs/apis/den-api.md) · [All operations](https://skmtc.net/openworklabs/apis/den-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openworklabs/den-api/versions/55ba7d5c7a7b/schema)