The API reference moved here from eksis.io/developers.

Telegram

Telegram publishes text, photo, video and carousel. Text-only posts are allowed (text). Media accepted: images and video. Comments are not available: A Telegram bot cannot read channel comments. Direct messages are not available. Post metrics are not available. First comments are not supported. On the Free plan, eksis publishes at most 25 posts per account per rolling 24 hours. Paid plans have no eksis cap and follow Telegram's own limit of 50 posts per account per rolling 24 hours.

Post types

TypeAPI valueWhat it publishesMedia itemsAccepts
TexttextA text message.NoneText only
PhotophotoOne photo with a caption.1Images
VideovideoOne video with a caption.1Video
CarouselcarouselAn album of 2 to 10 photos and videos. The caption shows on the first item.2 to 10Images and video, mixed

Media requirements

Photo (photo)

  • Images: up to 10 MB, aspect ratio 0.05:1 to 20:1.

Video (video)

  • Video: up to 50 MB, aspect ratio 0.05:1 to 20:1.
  • Images: up to 10 MB, aspect ratio 0.05:1 to 20:1.
  • Video: up to 50 MB, aspect ratio 0.05:1 to 20:1.

Text limits

This platform has no text limits beyond the post types above.

Settings

Options for Telegram go in targets[].settings of create and update post requests.

eksis optionFieldTypeValuesRequiredApplies to
Send without sound: Send without a notification sound. Subscribers still receive the post.settings.silentbooleanNoAll types
Protect content: Stop the post from being forwarded or saved.settings.protectContentbooleanNoAll types
No link preview: Show links in the text without a preview card. Text posts only.settings.disableLinkPreviewbooleanNotext

A value of the wrong type, or outside the allowed values, is refused with 422 and the code validation.failed, drafts included. An unknown key is dropped and reported in data.warnings.

Example target
{
  "channelId": "CHANNEL_ID",
  "contentType": "text",
  "settings": {
    "silent": true,
    "protectContent": false,
    "disableLinkPreview": false
  }
}

Comments and messages

  • First comment: not supported. A Telegram bot cannot comment on its own channel posts. A firstComment sent to this platform is refused with 422 and the code first_comment.unsupported.
  • Comments: not available. A Telegram bot cannot read channel comments.
  • Private reply to a comment: not supported.
  • Direct messages: not available. Subscribers of a channel cannot message it, so there are no direct messages to read.

Analytics

  • Post metrics: not available. A Telegram bot cannot read view counts or reactions on channel posts.
  • Audience: follower count is not tracked.

Daily limit

On the Free plan, eksis publishes up to 25 posts per Telegram channel a day. Telegram itself allows 50 posts per account a day, and that is the only daily limit on paid plans. A post over the limit is postponed, not failed.

Good to know

  • Posts go out through the eksis bot, @eksis_io_bot, which the chat owner adds to the channel or group.
  • In a channel the post shows under the channel name. In a group it shows as a message from the bot.
  • Each chat takes up to 50 posts in 24 hours from eksis, because the bot is shared by every workspace.
  • Photos up to 10 MB and videos up to 50 MB. Text is sent as written, without bold or italic formatting.
  • When Telegram does not answer, the post is not sent again, so it never goes out twice. Check the chat before retrying.

Webhook events

Events a Telegram channel can send to your webhook endpoints:

Rules verified on September 5, 2026.

On this page