Telegram API

Telegram's Bot API requires self-hosted bot management, separate methods for each media type, and manual rate limit handling. Zernio unifies it into one endpoint for channels and groups.

  • Free tier
  • No credit card
  • 99.97% uptime
Kestrel Updates12,480 subscribers

v2 is out ๐ŸŽ‰ Release notes and the migration guide are pinned in the channel.

Tuesday 118:30 AMScheduled

Join 200,000+ of the world's most ambitious developers and builders

Warner Music Group
Runable
ClickUp
MoFlo
RE/MAX
Readdy
How it works

Live in three steps, no Telegram app review

1

Profile

default

Telegram

Connect Telegram

Sign up for free, get your API key and connect Telegram accounts through our OAuth flow.

2

POST /v1/posts

const { data } = await zernio.posts.createPost({
  body: {
    content: 'v2 is live ๐Ÿš€',
    mediaItems: [{ url: 'https://cdn.acme.com/launch.jpg' }],
    platforms: [
      { platform: 'telegram', accountId: 'acc_8f2a' },
    ],
    scheduledFor: '2027-01-15T14:30:00',
    timezone: 'Europe/Madrid',
  },
});

Make one call

Send content to Telegram from one REST endpoint, right away or scheduled.

3

post.failed

Webhook sent to your app

Failed

Mon, 18 Jan

09:00, Europe/Madrid

Scheduled

v2 is live ๐Ÿš€

Fri, 15 Jan at 14:30

Published

Track every post

Follow each post from scheduled to published, with a webhook when one fails.

Endpoints

Telegram endpoints on one REST API

EndpointWhat it does
POST/v1/postsCreate or schedule a Telegram post (text, photos, videos, or albums)
GET/v1/posts/{id}Get status and details of a Telegram post
DELETE/v1/posts/{id}Cancel a scheduled Telegram post or delete a published message
GET/v1/profilesList all connected Telegram channels and groups
GET/v1/connect/telegramGenerate access code to connect a Telegram channel or group
POST/v1/connect/telegramDirect connection using chat ID (for power users)
PATCH/v1/connect/telegramCheck connection status for a pending access code
Media specs

What you can upload to Telegram

Zernio transcodes and optimizes media for Telegram's requirements automatically.

telegram/media-specs
TypeFormatMax sizeNotes
PhotoJPEG, PNG, GIF, WebP10 MBUp to 10 photos per album
VideoMP4, MOV50 MBUp to 10 videos per album
TextUTF-84096 charsHTML/Markdown supported
DocumentAny file type50 MBPDF, ZIP, etc.
Capabilities

Everything the API handles for you

Telegram has strict flood control limits. Zernio handles these automatically with intelligent queuing and retries for reliable posting.

Scheduling

Schedule posts for your best times.

Silent messages

Send without a notification sound.

Rich messages

Post text, photos, videos, and documents.

Media albums

Group up to 10 items into one album.

Channels and groups

Post to channels and groups alike.

Message deletion

Delete messages after they publish.

Formatting

Format messages with HTML or Markdown.

Status webhooks

Get notified the moment a post publishes or fails.

Response

What comes back from every call

Plain JSON back from every Telegram call, with the IDs and statuses your app needs to follow up.

cURL

$

{
  "post": {
    "_id": "65f1c0a9e2b5af0012ab34cd",
    "status": "published",
    "content": "Just launched our new API! Check it out ๐Ÿš€",
    "platforms": [{
      "platform": "telegram",
      "accountId": { "_id": "acc_abc123", "username": "My Channel" },
      "status": "published",
      "platformPostId": "123456",
      "platformPostUrl": "https://t.me/c/1234567890/123456"
    }],
    "publishedAt": "2025-01-10T10:30:00Z"
  },
  "message": "Post published successfully"
}

Start building with the Telegram API

Free tier available. No credit card required.

  • Free tier
  • No credit card
  • 99.97% uptime