Install Telegram integration

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