Mastodon posts with n8n and Bolta
Draft social posts from your n8n workflows. For Mastodon, Bolta saves a draft, you read the exact text, and nothing goes live until you say yes.
Checked 2026-11-21
Create an API key in Bolta, save it as a Bearer credential in n8n, then run one test item.
When a new blog post is published, save a Mastodon draft with the title, link and one hashtag for approval
Illustration of the reply: Bolta returns a draft showing the connected account and the scheduled time, with Approve, Edit and Reject actions.
What Bolta does on Mastodon
The text limit on Mastodon is set by your own instance, and Bolta reads it for the connected account instead of using one fixed number. The usual limit is 500 characters.
- Text posts, within the limit your instance sets.
- Public posts by default, or another visibility if you set it.
Mastodon limits and format rules
Bolta's posting rules for your workspace win if they differ from this page.
Not promised for Mastodon from n8n: Polls, threads and instance-specific features. None is confirmed for Bolta. Any rule from a particular instance. Each instance sets its own, so check yours.
| What to know | Mastodon's own rule | What Bolta does |
|---|---|---|
| Post length | Not stated on this page. | Set by your instance. Bolta reads it per account, and the usual limit is 500. Text over the limit is trimmed back to the last whole sentence or word that fits. |
| Visibility | Not stated on this page. | Public unless you set another visibility. |
| Formatting | Not stated on this page. | Mastodon posts are plain text here. Markdown is flattened, and #hashtags and @mentions stay as typed. |
| Finding conversations | Not stated on this page. | Hashtag-based. The query is folded into a single tag, because full-text status search is unavailable on most instances. |
n8n jobs for Mastodon, and how to write them
- Let an AI Agent draft a week of posts in your brand voice
- Ask for your instance's limit before drafting. It differs from instance to instance.
Example prompts for Mastodon
Ways to start a Mastodon draft from n8n. Each one saves a draft and stops.
When a new blog post is published, save a Mastodon draft with the title, link and one hashtag for approval
Look at my last five published posts and tell me which one did best, in two sentences.
When a release is tagged, save a Mastodon draft inside the instance limit and hold it for review
Pick the right brand from the form answer before drafting. If it is unclear, stop and ask.
Bolta saves a draft, you read the exact text, you say yes
- 01
A step saves a draft
n8n sends the Mastodon post to Bolta as a draft. Saving does not approve, schedule or publish it.
- 02
You read the exact text in Bolta
On Mastodon the exact text includes its visibility, because the default is public, and where the limit for your instance would cut it.
- 03
You say yes in Bolta
Only your yes approves and schedules it. Safe Mode, client sign-off and brand approval rules still apply.
Using n8n for Mastodon
For Mastodon, n8n reaches Bolta through a Bearer credential in n8n that holds a Bolta API key. The Mastodon account itself is connected inside Bolta, not in n8n.
n8n keeps the Bolta key as a Bearer credential, and a workflow can save a Mastodon draft from a trigger such as a new blog item. A workflow can save drafts, but it cannot approve them.
This connection uses a Bolta API key, which acts as you. Safe Mode and client sign-off still apply to every Mastodon post it saves, so keep them on.
An illustration from the n8n guide, not real output. You ask: Show what is waiting for approval and write me a three-line note I can post to the team channel. The reply goes along these lines: I listed the items waiting and drafted a short note for you. I did not approve anything. Read only. Nothing approved.
The MCP Client Tool path lets the AI Agent choose which Bolta tools to call, so it can handle an item that needs a brand lookup first. The cost is that its steps vary from run to run.
- Write in the brand voice. An AI Agent can read the brand voice before writing, so drafts from automation match drafts from people. Without that read it writes generically.
- Check the rules first. The workflow can read what an account allows before it writes, which avoids drafts that are too long or the wrong kind for that network.
- It saves a draft. The text is saved as a draft on the chosen account. A draft is the end of the unattended part.
- A person decides. You open Bolta, read the draft and approve it, change it or reject it. Nothing is approved, scheduled or published until a person says yes.
- Setup: Create a Bolta API key. In Bolta, open Settings, API Keys and create a key for the brand this workflow should post for. For drafts and reading, tick Read Workspace, Read Accounts, Read Posts and Write Posts. The key starts with bolta_sk_ and is shown once, so copy it now.
- Setup: Save the key in n8n as a credential. In n8n, open Credentials and create a Bearer credential. Paste your bolta_sk_ key as the token and name it something clear. If you use a Generic header instead, the name is Authorization and the value is Bearer followed by your key.
- MCP with an API key. Add the MCP Client Tool to an AI Agent, use https://mcp.bolta.ai/mcp, set authentication to Bearer and pick a credential holding your bolta_sk_ key. Needs n8n 1.104 or newer for HTTP Streamable.
- A Bolta routine you confirmed keeps running on Bolta's side, independent of n8n.
Connect n8n to Bolta
Create an API key in Bolta, save it as a Bearer credential in n8n, then run one test item.
Mastodon questions, answered for n8n
- What is the Mastodon character limit for a post from n8n?
- It depends on your instance. Bolta reads the limit for the connected account, and the usual limit is 500 characters. Anything over it is trimmed back to the last whole sentence or word.
- Are Mastodon posts from n8n public?
- Yes, unless you set another visibility. Say who may see the post when you ask, and check it when you read the draft.
- Does Bolta publish without my approval?
- No. A workflow can save drafts on its own, but nothing is approved, scheduled or published until a person says yes. Approving stays with you in Bolta, and Safe Mode and client sign-off still apply.
- Which permissions should the key have?
- For drafting and reading, tick Read Workspace, Read Accounts, Read Posts and Write Posts. Leave the rest off. A call that needs a permission the key lacks returns a 403, and the fix is to edit the key or make a new one.
- What does the node answer if the key is wrong?
- The MCP node reports Invalid or expired API key, and an HTTP Request node returns a 401. Check the credential sends Authorization with the value Bearer bolta_sk_ followed by your key, with one space after the word Bearer. Sending the same key again gives the same answer, so replace the key.
- Can a workflow approve or schedule posts by itself?
- It can save drafts without anyone watching. Approving and scheduling stay with a person, and the System Message we suggest tells the agent to stop at a draft. Treat that message as a guard rail and rely on the Bolta approval rules for the real limit.
- Does n8n publish Mastodon posts without my yes?
- No. A n8n step can save a Mastodon draft, not approve it. It waits in Bolta for a person to say yes.
More from n8n
n8n can work with the other networks Bolta publishes to. Each page has its own limits and review notes.
Mastodon from other AI agents
The same Mastodon limits apply whichever agent asks. The connection and the setup are what change.
Try a Mastodon draft from n8n
Connect n8n, ask for a Mastodon draft and read the exact text. Nothing goes live until you say yes.