Mastodon API

Post to the Fediverse with One API

Publish to any Mastodon instance with visibility control, content warnings, and polls. One integration for the whole fediverse.

Mastodon accounts are connected on the Schedulala dashboard (per-instance OAuth) — API-based connect is coming

publish.js
javascript
const response = await fetch('https://schedulala.com/api/v1/posts', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk_live_...',
    'Content-Type': 'application/json'
  },  
  body: JSON.stringify({
    content: 'Hello from the API!',
    platforms: [{
      platform: 'mastodon',
      accountId: 'you@mastodon.social'
    }]
  })
});

Supported Content Types

Everything Mastodon supports, available through one API.

📝Text Posts📷Photos🎥Videos📊Polls

Mastodon API vs Schedulala

Skip months of integration work. We handle the hard parts.

Direct Mastodon API

  • OAuth is per-instance — every Mastodon server needs its own app registration
  • Media must be uploaded and processed before the status can reference it
  • Character and media limits vary by instance configuration
  • Polls and media attachments are mutually exclusive
  • Rate limits differ from instance to instance

With Schedulala

  • One POST request publishes to any connected instance
  • We handle per-instance app registration and token management
  • Media upload, processing, and attachment handled automatically
  • Visibility, content warnings, and polls via simple platformSettings
  • Same request shape as the other platforms — nothing fediverse-specific to learn

Mastodon Media Limits

Quick reference for Mastodon's content specifications.

📝Caption / Text
500 characters
🖼️Max Image Size
16 MB
🎥Max Video Size
99 MB
⏱️Video Duration
No hard limit (size-capped)
🎠Carousel Items
4 images
📷Image Formats
JPEG, PNG, GIF, WebP, HEIC, AVIF
🎬Video Formats
MP4, MOV, WebM, M4V
📐Aspect Ratio
Any

Mastodon Integration in 3 Steps

From zero to publishing in minutes, not months.

1🔗

Connect

Your users connect their account through our hosted OAuth flow. We handle tokens, refresh, and permissions.

2🛠️

Build

Send a POST request with your content and target platform. Our SDK and REST API make integration simple.

3🚀

We Handle Publishing

We queue, validate, upload media, and publish to the platform. You get a webhook when it's live.

Mastodon-Specific Features

Built for the unique requirements of Mastodon.

🌐

Any Instance

mastodon.social, fosstodon.org, your own server — connect accounts on any instance and publish through one API.

👁️

Visibility Control

Public, unlisted, followers-only, or direct — set visibility per post with a single field.

📊

Content Warnings & Polls

First-class support for spoiler text, sensitive media flags, and native Mastodon polls.

Mastodon API FAQ

Common questions about the Mastodon integration.

Any instance. Users connect their account on the Schedulala dashboard (it asks for the instance domain), and we register with that instance automatically. You then post via the API like any other platform.

Explore Other Platforms

One API, 12 platforms. Publish everywhere from a single integration.

Start Publishing to Mastodon

7-day free trial. Start posting in minutes.