Scheduling
Schedule posts for your best times.
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.

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


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

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', }, });
Send content to Telegram from one REST endpoint, right away or scheduled.

post.failed
Webhook sent to your app
Mon, 18 Jan
09:00, Europe/Madrid
v2 is live ๐
Fri, 15 Jan at 14:30
Follow each post from scheduled to published, with a webhook when one fails.
| Endpoint | What it does |
|---|---|
POST/v1/posts | Create 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/profiles | List all connected Telegram channels and groups |
GET/v1/connect/telegram | Generate access code to connect a Telegram channel or group |
POST/v1/connect/telegram | Direct connection using chat ID (for power users) |
PATCH/v1/connect/telegram | Check connection status for a pending access code |
Zernio transcodes and optimizes media for Telegram's requirements automatically.
| Type | Format | Max size | Notes |
|---|---|---|---|
| Photo | JPEG, PNG, GIF, WebP | 10 MB | Up to 10 photos per album |
| Video | MP4, MOV | 50 MB | Up to 10 videos per album |
| Text | UTF-8 | 4096 chars | HTML/Markdown supported |
| Document | Any file type | 50 MB | PDF, ZIP, etc. |
Telegram has strict flood control limits. Zernio handles these automatically with intelligent queuing and retries for reliable posting.
Schedule posts for your best times.
Send without a notification sound.
Post text, photos, videos, and documents.
Group up to 10 items into one album.
Post to channels and groups alike.
Delete messages after they publish.
Format messages with HTML or Markdown.
Get notified the moment a post publishes or fails.
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"
}Free tier available. No credit card required.