Minipostiz Mastodon Setup

minipostiz-cli — Mastodon Setup

Mastodon is federated — your instance URL matters. Each instance has its own API.

What you need

Step 1 — Create an Application on your instance

1. Log in to your Mastodon instance (e.g. https://mastodon.social)
2. Go to Preferences → Development → New application
3. Fill in:
   • Application name: minipostiz
   • Website: any URL
   • Redirect URI: leave as urn:ietf:wg:oauth:2.0:oob
   • Scopes: check write:statuses and write:media (uncheck everything else)
4. Click Submit
5. Click the app name → copy Your access token

The access token shown on the app page is already authorized for your account — no OAuth flow needed.

Step 2 — Store in minipostiz-cli

minipostiz auth --platform mastodon \
  --instanceUrl "https://mastodon.social" \
  --accessToken "YOUR_ACCESS_TOKEN"

# Or via supercli
sc minipostiz auth set-mastodon \
  --instanceUrl "https://mastodon.social" \
  --accessToken "YOUR_ACCESS_TOKEN"

Replace mastodon.social with your actual instance domain.

Step 3 — Test

minipostiz auth verify --platform mastodon
minipostiz publish --platform mastodon --message "Hello from minipostiz-cli"

Visibility options

Store a default visibility by adding it to auth:

minipostiz auth --platform mastodon \
  --instanceUrl "https://mastodon.social" \
  --accessToken "TOKEN" \
  --visibility "unlisted"   # public | unlisted | private | direct

Troubleshooting

Token lifetime

Mastodon access tokens do not expire unless the application is deleted or access is revoked.