# How to Schedule Posts on Mastodon (Web, API and Apps)

Published: 2026-11-04

**Key takeaways:** Mastodon servers have a built-in scheduler, but the official website and apps have no button for it. Use the API's scheduled_at field (5 minutes ahead, 25 a day, 300 waiting), a third-party app, or a scheduler like PostBoost, which also handles threads, visibility and your server's character limit.

**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](/tools/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](https://docs.joinmastodon.org/methods/statuses/) 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:

```bash
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](https://docs.joinmastodon.org/methods/scheduled_statuses/). 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`](https://github.com/mastodon/mastodon/blob/main/app/models/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](https://fedi.tips/scheduling-posts-on-mastodon/) 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

1. In the sidebar, open **Accounts** (under Configuration; you need to be a workspace admin).
2. Click **Connect account** and choose **Mastodon**.
3. 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`.
4. 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 `@name@example.social` counts only the `@name` part. [How emoji and links count per network](/learn/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

1. 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.
2. 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](/tools/x-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:

```bash
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](/docs/api/validate-post). Every field is in the [createPost reference](/docs/api/create-post).

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](/docs/guardrails).

## 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](/learn/schedule-social-media-posts-with-claude) covers the setup.

## Before you hit Schedule

- Count it: the [social media character counter](/tools/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](/tools/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](/app/register), connect your Mastodon server and schedule your first post. Plans are on the [pricing page](/#pricing).

## Do this in PostBoost

- [Publish and schedule](https://postboost.co/features/publish): Write one post, adjust it for each account, then schedule it, add it to your queue or publish now.

## Free tools for this guide

- [Social media character counter](https://postboost.co/tools/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.
- [X thread maker: split long text into numbered posts](https://postboost.co/tools/x-thread-maker): 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.
- [Social media post checker: check your post before you publish](https://postboost.co/tools/social-media-post-checker): 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)](https://docs.joinmastodon.org/methods/statuses/)
- [Mastodon documentation: scheduled statuses methods](https://docs.joinmastodon.org/methods/scheduled_statuses/)
- [Mastodon source: ScheduledStatus limits (25 per day, 300 total, 5-minute minimum)](https://github.com/mastodon/mastodon/blob/main/app/models/scheduled_status.rb)
- [Mastodon source: status length validator (500 characters, links count as 23)](https://github.com/mastodon/mastodon/blob/main/app/validators/status_length_validator.rb)
- [Fedi.Tips: Scheduling posts on Mastodon (apps with built-in scheduling)](https://fedi.tips/scheduling-posts-on-mastodon/)
- [PostBoost API reference: createPost](https://postboost.co/docs/api/create-post)
- [PostBoost docs: guardrails and daily caps per network](https://postboost.co/docs/guardrails)

Canonical: https://postboost.co/learn/how-to-schedule-posts-on-mastodon
