n8n + Mastodon
Post to Mastodon from n8n
Send Mastodon posts from n8n to BrokenPost. Your workflow builds the post, BrokenPost posts it to Mastodon at the time you set.
How to connect n8n to Mastodon
- 1
Connect Mastodon in BrokenPost. Sign in with your Mastodon account.
- 2
In BrokenPost, open Plugins and copy your API key.
- 3
In n8n, install the BrokenPost community node (the Plugins page links to it).
- 4
Add your API key as a credential.
- 5
Add a BrokenPost step to any workflow to create posts.
Prefer another way? See every way to connect n8n.
Mastodon workflows to build in n8n
Each one ends with a step that sends the post to BrokenPost.
- “When a new row is added to a spreadsheet, schedule a Mastodon post with its text at the time in the row.”
- “When a new blog post shows up in your RSS feed, schedule a Mastodon post that links to it.”
- “When someone submits a form, save a Mastodon post as a draft for your team to approve.”
- “When a product is added to your store, post it to Mastodon the next morning.”
What happens next
- 1
Your n8n workflow starts from its trigger, like a new row, a form or an RSS item.
- 2
It sends the text, the date and the channel to the BrokenPost public API.
- 3
BrokenPost pulls in any media and saves the post on your calendar, as scheduled or as a draft.
- 4
At the set time BrokenPost publishes it to Mastodon. If Mastodon rejects it, the post shows as failed with the reason.
Mastodon limits to build for
Keep each post inside these limits. If Mastodon rejects one, it shows as failed on your calendar with the reason.
| Characters | 500 characters |
|---|---|
| Media | Pictures or video |
| Threads | Yes, as replies |
If Mastodon rejects a post
The post shows as failed on your calendar with one of these messages.
| What you see | How to fix it |
|---|---|
| The media was still processing when the post was published, please try again | Big videos need time on Mastodon. Retry the post a few minutes later. |
| Your login is currently disabled | Your Mastodon server disabled the account. Sign in on Mastodon to sort it out, then reconnect. |
Good to know
- Each part can have up to 500 characters.
- Big videos take Mastodon a while to process, so upload them well before the post time.
- Send the post as a draft when you want someone to check it in BrokenPost first.
Questions people ask
Can n8n post to Mastodon?
Yes, through BrokenPost. Connect Mastodon in BrokenPost, then send posts to the BrokenPost public API from n8n.
What are the Mastodon limits?
500 characters. Pictures or video. If Mastodon rejects a post, it shows as failed on your BrokenPost calendar with the reason.
Can n8n schedule Mastodon posts for later?
Yes. Send a date and time with the post and it goes out then, or send it as a draft to check it first.
Is it free?
The public API works on every plan. The Free plan includes 1 account on every app and 20 posts a month. Paid plans start at $19 a month with unlimited posts.
More apps with n8n
Post to Mastodon with other AI
Write once. Post everywhere.
Start free with BrokenPost. Connect your apps and your AI in a few minutes.