Connect Telegram first
- 01
Add the 1Post bot to your channel or group as an administrator, or create your own bot with BotFather.
- 02
Open Accounts in 1Post and choose Connect, then Telegram.
- 03
Enter the channel and, if you use your own bot, its token.
- 04
Choose the channel in the composer.
Then GET /v1/accounts returns the id of the Telegram channel to use in the request.
Send a post to Telegram
curl https://api.get1post.com/v1/posts \
-H "Authorization: Bearer $ONEPOST_API_KEY" \
-H "Idempotency-Key: telegram-first-post" \
-d '{"accounts":["ACCOUNT_ID"],"text":"The update is live.","schedule_at":"2026-11-02T15:00:00Z"}'The reply is 202 with the post (status scheduled) and one destination for Telegram, which moves from queued to published or failed.
What you can send to Telegram
- Text
- Photo
- Video
- Album of 2 to 10 items
What Telegram publishes
- A message holds 1 to 4096 characters, a caption up to 1024, and an album 2 to 10 items.
Telegram rules the request is checked against
| Rule | What 1Post checks |
|---|---|
| Text limit | 4,096 characters, counted in UTF-16 units |
| Caption limit with media | 1,024 characters |
| Media accepted | Images, Video |
| Images per post | 10 |
| Videos per post | 10 |
| Carousel | 2 to 10 items |
| Threads | No |
| First comment | No |
| Posts per day, per connected account (1Post) | 100 |
The same table with sources is on the Telegram specs page.
Check the post before it is queued
Add "dry_run": true to test a post: nothing is kept, a valid one answers 200 and a broken one answers 422 naming the rule.
{
"error": {
"code": "invalid_for_platform",
"message": "telegram refuses this post: Telegram counts 4,128 of 4,096 characters in part 1. (text_too_long).",
"fix": "Fix the rule named in the message and send the post again.",
"retryable": false,
"request_id": "REQUEST_ID"
}
}An assistant connected to the MCP server sends the same fields to create_post; set one up.