Install Telegram integration | Runtype Documentation

Install or upsert a Telegram bot integration for the authenticated owner, writing bot token and webhook secret into the secret store and registering the webhook with Telegram.

Authentication

AuthorizationBearer

API key or Clerk session token

Request

This endpoint expects an object.

botIdstringRequired>=1 character

botTokenstringRequired>=1 character

botNamestringOptional>=1 character

botUsernamestringOptional>=1 character

integrationIdstringOptional>=1 character

surfaceIdstringOptional>=1 character

webhookSecretstringOptional>=1 character

Response

Telegram integration installed

createdboolean

integrationIdstring

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

502

Bad Gateway Error

$	curl -X POST https://api.runtype.com/v1/integrations/telegram/install \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"botId": "123456789",
>	"botToken": "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"
>	}'

$	curl -X POST https://api.runtype.com/v1/integrations/telegram/install \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"botId": "123456789",
>	"botToken": "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"
>	}'

1	{
2	"created": true,
3	"integrationId": "telegram-integration-987654321"
4	}