Guide
Mastodon
Any Mastodon server, connected in one step.
platform: mastodon
Socialit registers an app on your server automatically, then posts with content warnings, visibility, polls and threads. Mentions, replies and direct messages land in the inbox.
Connect
Sign in with Mastodon (OAuth). Socialit refreshes tokens in the background.
Use the hosted or headless flow described in Connecting accounts. Once connected, the account appears in GET /v1/accounts?platform=mastodon.
Publish
| Post type | Limits and notes |
|---|---|
| Text | Up to 500 characters. Server-dependent; many servers allow more |
| Images | Up to 4 per post |
| Video | – |
| Polls | – |
| Threads | – |
curl https://api.socialit.com/v1/posts \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"content": "Focus mode is live. Open one account, use everything.",
"account_ids": [
"sa_mastodon…"
],
"scheduled_at": "2026-10-14T09:00:00.000Z",
"platform_options": {
"mastodon": {
"visibility": "public",
"spoiler_text": ""
}
}
}'Network-specific options go under platform_options.mastodon (schemas: GET /v1/posts/platform-options). Socialit validates them before publishing and returns 422 with per-field errors otherwise.
Capabilities
| Publishing | Yes |
| Direct messages | Yes |
| Comments | Yes |
| Reviews | No |
| Mentions | Yes |
| Analytics | Post and account metrics |
| Edit after publishing | Yes |
| Delete or unpublish | Yes |
| First comment | No |
Focus mode
In Focus mode a Mastodon account exposes:
- Content warnings, visibility and language
- Polls, threads and quote posts
- Notifications, mentions and direct messages
- Lists, filters and follows
- Favourites, boosts and bookmarks
Each resource is also available at /v1/accounts/{id}/focus/{resource}.