Home / n8n / Mastodon

n8n Mastodon Upload API Automated Fediverse Posting

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

n8n-mastodon.json

// n8n HTTP Request — Mastodon upload
const node = {`{`}
  type: 'n8n-nodes-base.httpRequest',
  parameters: {`{`}
    method: 'POST',
    url: 'https://api.upload-post.com/api/upload',
    platform: ['mastodon'],
    title: 'My Mastodon toot'
  {`}`}
{`}`};

Upload Flow

Prepare Content

Get your text status, photos, or video ready.

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

Upload via API

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

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

Check Status

Poll until processing completes.

• Video is processed async
• Get status URL

Posted!

Status is live on your Mastodon timeline.

• Auto-published
• Federates across the Fediverse

Automate Mastodon Publishing

Start for Free

Workflows

Multi-Platform Publishing

Post to Mastodon and other platforms at once.

AI Content Generation

Generate content with AI and post it to Mastodon.

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

Create Free Account

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.

[email protected]