Skip to content
Docs

Guide

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 typeLimits and notes
TextUp to 500 characters. Server-dependent; many servers allow more
ImagesUp to 4 per post
Video–
Polls–
Threads–
POST /v1/posts
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

PublishingYes
Direct messagesYes
CommentsYes
ReviewsNo
MentionsYes
AnalyticsPost and account metrics
Edit after publishingYes
Delete or unpublishYes
First commentNo

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}.