Platform guide
Telegram
Requires a bot token and a destination chat or channel where that bot has permission to post.
available4,096 characters10 media items
Capabilities at a glance
AnalyticsNot availableCommentsNot availableMessagesSupportedRemote deletionSupportedToken refreshNot available
01
Connect Telegram
Create the hosted connection URL on your server. The customer completes OAuth or the provider-specific credential form directly on PostGate.
Connection requestPostGate API
curl -X POST https://postgate.studio/api/profiles/connect \
-H "Authorization: Bearer $POSTGATE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"platform": "telegram",
"profile_group_id": "grp_acme123",
"return_url": "https://app.example.com/settings/social"
}'02
Publish to Telegram
Use the connected profile ID as the target. Provider-specific fields live under post.options.telegram so the unified envelope remains stable.
Post envelopePostGate API
{
"post": {
"body": "Launch day.",
"options": {
"telegram": {
"disable_link_preview": false
}
}
},
"profiles": [
"pro_telegram123"
],
"media": [
"med_01JXYZ"
]
}03
Media and content limits
PostGate validates the request at creation and again at delivery. Account-level provider limits can be narrower than the general contract.
Text4,096 characters
LinksAllowed
Mediaimages and video · Up to 10
Image size5 MB
Video size50 MB
Video durationUp to Provider default
04
Operational notes
These constraints affect approval, connection health, or delivery behavior for this provider.
Bot must be an administrator of the destination channel or group.
Check live capability before showing the option
Call
GET /api/platforms. A provider appears only when it is enabled and configured for the current workspace.