Use case
How to schedule posts to Bluesky and Mastodon
Bluesky and Mastodon both offer open, documented APIs, which means a scheduler can post for you without screen-scraping or shared passwords. This guide shows how to connect each one safely and what to know about their limits.
Connect Bluesky with an app password
Bluesky lets you create app passwords: separate passwords for apps, which you can revoke at any time without changing your main password. Postline refuses your main account password and asks for an app password instead.
- In Bluesky, open Settings, then Privacy and security, then App passwords, and create a new one named "Postline".
- In Postline, choose Connect Bluesky and enter your handle and the app password.
- Postline signs in once to check it works, then stores the login encrypted. It is never shown again.
- To disconnect, remove the channel in Postline (the stored login is deleted) and revoke the app password in Bluesky.
Connect Mastodon with an access token
Mastodon is made of many independent servers. You connect the account on your own server with an access token that only allows what Postline needs.
- On your Mastodon server, open Preferences, then Development, then New application.
- Name it "Postline" and give it permission to write statuses and upload media.
- Copy the access token.
- In Postline, choose Connect Mastodon, enter your server address (for example mastodon.social) and the token.
Postline reads your server's own limits when you connect, because servers can change the default character and media limits.
Write within each network's limits
| Bluesky | Mastodon (default) | |
|---|---|---|
| Text length | 300 graphemes (characters as you see them) | 500 characters; each server can set its own |
| Images per post | Up to 4 | Up to 4 attachments by default |
| Links | Counted as typed | Count as 23 characters |
Bluesky counts graphemes, so an emoji with a skin tone counts as one. Postline counts the same way and blocks approval if a post is too long for any selected network. Postline does not upload video to Bluesky; Bluesky posts carry text and up to four images, each up to 1 MB.
Schedule and let it post
- Write the post, attach images from the media library and select the Bluesky and Mastodon channels.
- Send it for review and approve it.
- Pick the time. Postline shows times in your time zone and stores them in UTC.
- At the scheduled minute, the cron worker posts to each channel and records the link to each post.
If a network is briefly unavailable, Postline retries with increasing delays. If a login was revoked, the post fails with that reason and you can reconnect. Before posting again after an uncertain error, Postline checks whether the post already exists, so it never posts twice.
Links, mentions and hashtags
On Bluesky, links, @mentions and #hashtags are made clickable by "facets" attached to the post; Postline adds them for you. A mention becomes a link only if the handle exists. On Mastodon, the server makes links, mentions and hashtags clickable itself.
Privacy and security
Postline posts only through each platform's official API with a login you create for it. The login is stored encrypted and deleted when you disconnect. Nothing is posted unless a post was approved and scheduled.
Questions and answers
What happens if my Mastodon server is down at the scheduled time?
Postline retries with increasing delays. If it still fails, the post shows the reason on the calendar and you can reschedule it.
Why not my normal Bluesky password?
App passwords can be revoked without changing your main password and cannot change your account settings. Postline only accepts app passwords.
Can I post the same text to both?
Yes. Select both channels; Postline checks the text against each one's limits.
Can Postline post videos to Bluesky?
No. Bluesky posts from Postline carry text and up to four images.
Sources
- app.bsky.feed.post record schema (Bluesky (AT Protocol lexicons)), last checked 2026-11-12.
- Instance methods: configuration.statuses (Mastodon documentation), last checked 2026-11-12.