Home / n8n / Mastodon
Mastodon

n8n Mastodon Upload API Automated Fediverse Posting

Post text, photos, and videos to any Mastodon instance from n8n.

Upload Flow

01

Prepare Content

Get your text status, photos, or video ready.

  • • Text statuses (toots)
  • • Up to 4 images per status
  • • Native video supported
02

Upload via API

POST to Upload-Post with platform[]=mastodon.

  • • Include status text
  • • Works with any instance
  • • Instance URL + access token
03

Check Status

Poll until processing completes.

  • • Video is processed async
  • • Get status URL
04

Posted!

Status is live on your Mastodon timeline.

  • • Auto-published
  • • Federates across the Fediverse

Automate Mastodon Publishing

FAQ

Which instances work?

n8n Mastodon automation works with mastodon.social or any self-hosted instance. Connect once with your instance URL and a personal access token.

Supported content types

Publish text statuses (toots), attach up to four images to a single status, or upload native video handled through async processing.

Do I need an OAuth app?

No. Upload-Post posts to Mastodon from n8n using a personal access token from your instance — no custom OAuth app registration required.

How long does video take?

Mastodon processes video asynchronously. Poll the Upload-Post status endpoint from n8n until the status is published.

Can I schedule toots?

Yes. Combine the n8n Schedule Trigger with Upload-Post, or use Upload-Post's built-in scheduling to queue Mastodon posts.

Start publishing to Mastodon

Get in Touch

We're here to help you streamline your social media workflow

Have questions? We'd love to hear from you.

Send us a message and we'll respond as soon as possible.