Mastodon Integration

Mastodon Posting API

Post text, photos and videos to Mastodon on any instance — with the same API call you use for every other platform.

Start Posting Free

What You Can Post to Mastodon

Mastodon connects with your instance URL and an access token from an application you create on that instance, with the write:statuses and write:media scopes.

Text Posts

Publish posts of up to 500 characters, the default Mastodon limit.

Photos

Attach up to 4 photos to a post.

Videos

Post a single video per post, up to 40 MB.

Quick Start: Mastodon Posting API

Once Mastodon is connected to a profile, posting is one request. Replace YOUR_API_KEY with an API key from your dashboard and my-brand with your profile name.

curl -X POST https://api.indreelforge.com/api/upload_text \
  -H 'Authorization: Apikey YOUR_API_KEY' \
  -F 'user=my-brand' \
  -F 'title=Hello fediverse! We are now posting here too.' \
  -F 'platform[]=mastodon' \
  -F 'platform[]=bluesky'

This request posts the same update to Mastodon and Bluesky. Use /api/upload_photos or /api/upload for photo and video posts. Read the Mastodon guide →

Key Features for Mastodon

Any Instance

Works with mastodon.social or any other Mastodon server — just enter its address when you connect.

Scoped Access Token

You create the token on your own instance with only write:statuses and write:media. IndReelForge verifies it before saving and stores it encrypted.

Scheduling

Schedule Mastodon posts from the dashboard or the API to keep a steady presence on the fediverse.

Cross-Platform Posting

Post to Mastodon, Bluesky, Threads, X and more in one request, with per-platform text overrides like mastodon_title.

How It Works

1

Create an Application

On your Mastodon instance, open Preferences → Development → New application.

2

Pick the Scopes

Tick write:statuses and write:media, save, and copy "Your access token".

3

Connect It to a Profile

In the IndReelForge dashboard, open a profile, click Connect next to Mastodon and enter your instance URL and token. We verify them live.

4

Post via API or Dashboard

Send platform[]=mastodon with the upload endpoints, or post and schedule from the dashboard.

Who Uses the Mastodon Posting API?

Open-Source Projects

Share releases and updates with the developer-heavy Mastodon audience alongside your other channels.

Creators

Cross-post to the fediverse without managing another app or copying posts by hand.

Organisations

Keep an official Mastodon account up to date from the same publishing workflow as your other accounts.

Mastodon API FAQ

Can I post to Mastodon via API?

Yes. Connect your instance URL and an access token to a profile, then send platform[]=mastodon with the IndReelForge upload endpoints to post text, photos or a video.

Does it work with any Mastodon instance?

Yes. Enter the address of your server, such as https://mastodon.social, when you connect.

Which scopes does the access token need?

write:statuses to publish posts and write:media to upload photos and videos. Other scopes are not needed.

How many photos can a Mastodon post have?

Up to 4 photos, or 1 video, per post. Video files can be up to 40 MB.

Mastodon Posting API Pricing

Start with the free plan, which includes 10 uploads per month shared across your connected platforms. No credit card required.

View all pricing plans →

Explore More

Other platforms

Automation & no-code

Get started

Start Posting to Mastodon Today

Create an access token on your instance, connect it in under a minute, and post to Mastodon from one API call.

Get Your Free API Key