Guide · By PostBoost team · · Markdown
Short answer: Mastodon can schedule posts, but you won't find the button. Every Mastodon server since version 2.7 has a scheduler in its API: send a post with a scheduled_at time and the server holds it until then. The official website and apps don't use it. So you schedule through a third-party app that does, through the API yourself, or through a scheduler like PostBoost: connect your server once, write the post, pick a time and click Schedule. Paste the text into the free social media character counter first to check it fits Mastodon's 500 characters.
Three ways to schedule a Mastodon post
Mastodon API (scheduled_at) |
Third-party Mastodon app | A scheduler like PostBoost | |
|---|---|---|---|
| Needs code | Yes, an HTTP call | No | No (API optional) |
| Where the post waits | On your Mastodon server | On your Mastodon server | In PostBoost |
| Limits | 25 a day, 300 waiting, 5 min ahead | Same as the API | None from Mastodon's scheduler |
| Schedule a thread | No | No | Yes |
| Same post to other networks | No | No | Yes |
Mastodon's built-in scheduler
The scheduler is part of the post endpoint. Mastodon's docs describe scheduled_at as the datetime "at which to schedule a status", which "must be at least 5 minutes in the future". Instead of a post you get back a scheduled status with an id:
curl -s -X POST "https://mastodon.social/api/v1/statuses" \
-H "Authorization: Bearer $MASTODON_TOKEN" \
-d "status=New guide: how we plan a month of posts in one afternoon." \
-d "scheduled_at=2026-11-10T14:30:00Z"
GET /api/v1/scheduled_statuses lists what is waiting, and you can move or cancel a post with the scheduled statuses methods. The token needs the write:statuses scope; you create one under Preferences → Development → New application on your server.
Mastodon's source code sets three limits on its scheduler (scheduled_status.rb):
- 5 minutes: a post must be scheduled more than 5 minutes ahead.
- 25 per day: no more than 25 scheduled posts on the same date.
- 300 in total: no more than 300 posts waiting per account.
It also can't schedule a thread. A reply needs the id of the post it answers, and a scheduled post has no post id until it is published.
Third-party apps
Several Mastodon apps put a schedule option in their composer and use the same server scheduler underneath. Fedi.Tips lists Tusky, Fedilab, Moshidon and Subway Tooter on Android, Mona on iPhone and iPad, Tuba on Linux and Windows, and Phanpy and FediPlan on the web. They are a good fit for one account and the odd post; the limits above still apply.
Schedule a Mastodon post in PostBoost
PostBoost doesn't hand your post to Mastodon's scheduler. It keeps the post and sends it to your server at the time you chose, so you can edit it until then, schedule threads, and post the same update to your other networks.
1. Connect your Mastodon account
- In the sidebar, open Accounts (under Configuration; you need to be a workspace admin).
- Click Connect account and choose Mastodon.
- Under Choose your server, pick yours (mastodon.social, mstdn.social, indieweb.social or fosstodon.org) or click Custom and type your server's address, such as
hachyderm.io. - Click Next. Your server's own sign-in page opens; log in and authorize PostBoost. You land back in PostBoost with the account connected.
PostBoost registers itself with your server automatically the first time someone connects from it, so there is no app or token to create by hand. It asks for the read write scope, which lets it post, upload media and read your posts and notifications for analytics.
2. Write the post
Open a new post and select the Mastodon account. The composer checks it against your server's rules:
- Your server's character limit. Most servers allow 500 characters, but each one sets its own. When you connect, PostBoost reads the limit your server publishes and counts against that number, falling back to 500.
- Counted the way Mastodon counts. Any link with
https://counts as 23 characters however long it is, an emoji counts as 1, and a mention like@[email protected]counts only the@namepart. How emoji and links count per network compares this with X and Bluesky. - Up to 4 images, 1 video or 1 GIF. The composer reminds you when an image has no alt text. PostBoost sends the alt text with the upload, which Mastodon shows as the image description.
3. Set the Mastodon options
The Mastodon options panel in the composer sets what the official apps set on a normal post:
- Visibility: Public, Quiet public (public but kept out of the public timelines), Followers only or Mentioned people only.
- Who can quote: Anyone, Followers only or Just me. You can change it for Public and Quiet public posts; for Followers only and Mentioned people only it is locked to Just me. Quote controls arrived in Mastodon 4.5, and older servers ignore the setting.
- Mark media as sensitive: hides images and video behind a warning until someone clicks.
4. Pick the time and schedule
- Click Schedule and choose a date and time. The time zone is shown next to the time; the icon beside it opens your profile settings if you need to change it.
- Click Done, then Schedule.
The post appears in the calendar and goes out at that time. If you have a posting schedule, Add to Queue puts it in the account's next free slot instead. Posting to several networks at once? Set a time per account gives Mastodon its own time.
Schedule a Mastodon thread
Click Add Post in the composer for each next part. Each part is checked against your server's limit on its own, and PostBoost publishes the parts as replies to each other, in order, at the scheduled time. The free thread maker splits a long text into parts without cutting a word or a link; paste them into the composer.
Schedule Mastodon posts with the PostBoost API
Find the Mastodon account's id with GET /{workspaceUuid}/accounts, then create the post. This one is a two-part thread, public but kept out of the public timelines, scheduled for 10:00 Berlin time:
curl -s -X POST "https://postboost.co/app/api/$WORKSPACE_UUID/posts" \
-H "Authorization: Bearer $POSTBOOST_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"accounts": [42],
"schedule": true,
"date": "2026-11-10",
"time": "10:00",
"timezone": "Europe/Berlin",
"versions": [{
"account_id": 0,
"is_original": true,
"content": [
{ "body": "We planned a month of posts in one afternoon. Here is the checklist 🧵" },
{ "body": "1. Pick four themes, one per week. 2. Write the posts. 3. Schedule them all at once." }
],
"options": {
"mastodon": { "visibility": "unlisted", "quote_approval_policy": "followers" }
}
}]
}'
Item 0 of content is the post and each later item is the next part of the thread. visibility takes public, unlisted (Quiet public), private (Followers only) or direct; sensitive: true marks the media. If a part is over your server's limit, the call is refused with 422 and nothing is created. To check a post without creating it, send the same body to validatePost. Every field is in the createPost reference.
Two limits apply when a script schedules for you: up to 100 Mastodon posts per account per UTC day (half on the free plan), and a post that repeats one created for the same account in the last 24 hours is refused unless you set allow_duplicate. Both are in the guardrails docs.
Schedule Mastodon posts from Claude or ChatGPT
With the PostBoost connector added to your AI assistant, you can ask in plain language:
Write a two-post Mastodon thread about our monthly planning checklist, keep each post under 500 characters, and schedule it for Tuesday at 10:00 Berlin time.
The assistant finds the account with list-accounts, then calls create-post with the thread parts, schedule set to scheduled, a scheduled_at such as 2026-11-10 10:00 and the timezone Europe/Berlin. Ask it to run validate-post first if you want the rules checked before anything is saved. The assistant can't connect a Mastodon account for you, because PostBoost needs to know your server: connect it once in the app. Schedule social media posts with Claude covers the setup.
Before you hit Schedule
- Count it: the social media character counter shows the Mastodon count next to X, Bluesky and Threads, which matters when one post goes to all of them.
- Check it: the social media post checker flags a post that is too long, has too many images or breaks another network rule.
- Try it on your own account: create a free PostBoost account, connect your Mastodon server and schedule your first post. Plans are on the pricing page.
Do this in PostBoost
Free tools for this guide
Free tool
Social media character counter
Free character counter for X, Threads, Bluesky, Instagram, LinkedIn, TikTok and more. Counts as each network does, live in your browser.
Free tool
X thread maker: split long text into numbered posts
Split long text into numbered posts for X, Threads, Bluesky or Mastodon. Never cuts a word or a link. Free, no signup, runs in your browser.
Free tool
Social media post checker: check your post before you publish
Check a post before posting: character limits, hashtags, media count, video length and see-more cut-offs for X, Instagram, LinkedIn, TikTok and more.
FAQ
Can you schedule posts on Mastodon?
Yes, but not from the official website or apps. Mastodon servers have had a scheduler since version 2.7: a post sent through the API with a scheduled_at time waits on your server and goes out then. To use it you need a third-party app that exposes it, a script, or a scheduler such as PostBoost.
Why is there no schedule button on Mastodon?
The scheduler lives in the server's API, and the official web interface and apps have not added a button for it. Third-party apps such as Tusky, Fedilab, Moshidon, Mona, Tuba and Phanpy do offer scheduling.
How many posts can I schedule on Mastodon?
Through Mastodon's own scheduler, 25 posts per day and 300 waiting in total per account, each at least 5 minutes in the future. Those limits are in Mastodon's source code. Posts scheduled in PostBoost wait in PostBoost instead, so they don't count against them.
What is the Mastodon character limit for scheduled posts?
500 characters on most servers, but each server sets its own. PostBoost reads your server's limit when you connect the account and checks posts against it. A link that starts with http:// or https:// counts as 23 characters and a mention like @name@server counts as @name.
Can I schedule a Mastodon thread?
Yes. In PostBoost's composer, click Add Post for each next part. PostBoost publishes the parts as replies to each other, in order, at the scheduled time. Mastodon's own scheduler can't do this, because a reply needs the id of a post that doesn't exist yet.
Can I choose who sees a scheduled Mastodon post?
Yes. PostBoost's Mastodon options set the visibility (Public, Quiet public, Followers only or Mentioned people only), whether media is marked as sensitive, and who can quote the post.
Sources
- Mastodon documentation: POST /api/v1/statuses (scheduled_at, at least 5 minutes in the future)
- Mastodon documentation: scheduled statuses methods
- Mastodon source: ScheduledStatus limits (25 per day, 300 total, 5-minute minimum)
- Mastodon source: status length validator (500 characters, links count as 23)
- Fedi.Tips: Scheduling posts on Mastodon (apps with built-in scheduling)
- PostBoost API reference: createPost
- PostBoost docs: guardrails and daily caps per network