Minipostiz X Setup

minipostiz-cli — X (Twitter) Setup

X uses OAuth 1.0a for posting. You need 4 keys: API Key, API Secret, Access Token, Access Token Secret.

What you need

Step 1 — Create a Developer App

1. Go to https://developer.twitter.com/en/portal/dashboard
2. Sign in with your X account → click + Create Project
3. Fill in project name, use case, description → create
4. Create an App inside the project
5. In App Settings → User authentication settings → click Edit:
   • App permissions: Read and Write
   • Type of App: Web App, Automated App or Bot
   • Callback URI: http://localhost (required, not actually used)
   • Website URL: any valid URL
6. Save

Read and Write permission is required — Read-only tokens cannot post.

Step 2 — Get API Keys

In your app → Keys and Tokens tab:

1. API Key and Secret section → click Regenerate → copy both values immediately (secret shown once)
2. Access Token and Secret section → click Generate → copy both values immediately

If you already generated them and lost the secret, regenerate — old tokens are invalidated.

Step 3 — Store in minipostiz-cli

minipostiz auth --platform x \
  --apiKey "YOUR_API_KEY" \
  --apiSecret "YOUR_API_SECRET" \
  --accessToken "YOUR_ACCESS_TOKEN" \
  --accessSecret "YOUR_ACCESS_SECRET"

# Or via supercli
sc minipostiz auth set-x \
  --apiKey "YOUR_API_KEY" \
  --apiSecret "YOUR_API_SECRET" \
  --accessToken "YOUR_ACCESS_TOKEN" \
  --accessSecret "YOUR_ACCESS_SECRET"

Step 4 — Test

minipostiz publish --platform x --message "Hello from minipostiz-cli"
minipostiz history --platform x --limit 5

Troubleshooting

Free tier limits (as of 2025)

• Free tier: 500 tweets/month, no media upload
• Basic tier: 3,000 tweets/month, media upload supported
• minipostiz uses Twitter API v2 for posting and v1.1 for media upload

Token lifetime

OAuth 1.0a tokens do not expire unless you regenerate them or revoke app access.