Mastodon Upload API Text, Photos & Videos

Post content to Mastodon programmatically. Fediverse API simplified.

Start Free
mastodon-upload.ts 
import { UploadPost } from 'upload-post';

const uploader = new UploadPost('your-api-key');

await uploader.upload('video.mp4', {
  title: 'My Mastodon post',
  platforms: ['mastodon']
});

Mastodon API Features

Text Posts

Publish text statuses (toots) to your Mastodon timeline.

Photo Posts

Attach up to four images to a single status.

Video Posts

Upload native videos, handled through async processing.

Access Token

Publish using your instance URL and a personal access token.

Any Instance

Works with mastodon.social or any self-hosted instance.

Scheduling

Schedule posts for optimal engagement.

Ready to automate your Mastodon presence?

Start posting to Mastodon programmatically today.

Create Free Account

This endpoint is part of one social media API that covers 22 networks. See every supported platform or compare it with the alternatives in best social media APIs 2026.