Posting to Telegram through the API

Channels that reach people directly, with no feed algorithm in between. The request shape is the same one every network here uses — only the limits on this page change.

Telegram publishes for anyone today. Connect an account and the request below works as written.

Connecting a Telegram account

Bot token from @BotFather + your channel id. No developer app, no review. Once connected, we hold the credential and keep it alive; your code only ever sends the API key.

The limits we enforce before publishing

What pre-flight rejects, verbatim

A request that breaks a Telegram rule comes back as a 422 naming the network and the number — before anything is scheduled, not after the other networks published. The error strings are these:

• 1156 chars — Telegram allows 1024.
• 12 attachments — Telegram allows 10.
• Video is 2h 0m — Telegram allows 1h 0m.

The request

curl -X POST https://attentionpilot.com/api/v1/posts \
  -H "Authorization: Bearer $PILOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "Written for Telegram, under 1024 characters.",
    "accounts": ["telegram"]
  }'

Omit schedule for the next free queue slot, send "now" to publish immediately, or send an ISO timestamp.

When Telegram fails

Each network is delivered on its own. A revoked token or a rejected upload on Telegram never blocks your other targets: the post returns "partial", the Telegram target carries the error text, and you can retry just this delivery.

Worth knowing

• ✓Connect with a bot token and a channel id — no developer app, no review queue
• ✓1024 characters on a media caption, 4096 on a plain message
• ✓Up to 10 images in one group, or video up to 50 MB

The same call reaches the rest