javimosch minipostiz-cli — Facebook Setup
minipostiz-cli posts to Facebook Pages (not personal profiles — the Graph API doesn't support personal timeline posts). You need a Page Access Token and the Page ID.
What you need
| Credential | Flag |
|---|---|
| Page Access Token | --pageAccessToken |
| Page ID | --pageId |
Step 1 — Create a Facebook App
- Go to https://developers.facebook.com/apps → Create App
- Choose "Authenticate and request data from users" use case (Consumer type) → Next
- ⚠️ Do NOT pick Business type — it won't show
pages_manage_postsin Graph Explorer
- ⚠️ Do NOT pick Business type — it won't show
- Fill in app name and contact email → Create App
Step 2 — Add Pages permissions via Use Cases
The new Facebook developer dashboard (2024+) uses use cases instead of individual permission requests:
- In your app dashboard → click "Customize the Manage everything on your Page use case"
- Add the following permissions to that use case:
pages_manage_postspages_read_engagement
- Save — these are available in development mode without App Review for pages you admin
Note: There is no longer an "App Review → Permissions and Features" link in the dashboard. The use case customization screen is the replacement.
Step 3 — Get your Page Access Token
Via Graph API Explorer (recommended):
- Go to https://developers.facebook.com/tools/explorer/
- Select your app in the Application dropdown
- Click the blue Generate Access Token button (opens a Facebook Login popup — NOT "Get App Token")
- In the Permissions list, add
pages_manage_postsandpages_read_engagement - Authorize → in the User or Page dropdown → switch to your Page (e.g. "Savoie Tech")
- Copy the Page Access Token shown
Get your Page ID and a proper Page Token via curl (alternative):
# Use the User token to list all pages you manage + their page tokens
curl "https://graph.facebook.com/v21.0/me/accounts?access_token=YOUR_USER_TOKEN"
# Response includes each page's id and access_token — use those directly
Get a long-lived token (60 days instead of ~1 hour):
curl "https://graph.facebook.com/v21.0/oauth/access_token?\
grant_type=fb_exchange_token&\
client_id=YOUR_APP_ID&\
client_secret=YOUR_APP_SECRET&\
fb_exchange_token=YOUR_SHORT_LIVED_PAGE_TOKEN"
Step 4 — Store in minipostiz-cli
minipostiz auth --platform facebook \
--pageAccessToken "YOUR_PAGE_ACCESS_TOKEN" \
--pageId "123456789012345"
# Or via supercli
sc minipostiz auth set-facebook \
--pageAccessToken "YOUR_PAGE_ACCESS_TOKEN" \
--pageId "123456789012345"
Step 5 — Test
minipostiz auth verify --platform facebook
minipostiz publish --platform facebook --message "Hello from minipostiz-cli"
Troubleshooting
| Error | Cause | Fix |
|---|---|---|
190 Invalid OAuth access token |
Token expired or wrong type | Regenerate — ensure you clicked Generate Access Token (not "Get App Token") and switched to the Page token |
283 Requires pages_read_engagement |
Missing permission on token | Re-generate token with pages_read_engagement added; ensure use case is configured in app dashboard |
200 Permission error |
Missing pages_manage_posts |
Add permission via use case customization in app dashboard |
100 Object does not exist |
Token is a User token, not Page token | Switch to Page in the User/Page dropdown in Graph Explorer |
368 Blocked |
Page or account restricted | Check Page Quality in Facebook Business Suite |
Token lifetime
- Short-lived Page Token: ~1-2 hours
- Long-lived Page Token: ~60 days (use the exchange flow above)
- Never-expiring Page Token: possible for some page roles — check Meta docs
Re-generating tokens
When your token expires, repeat Step 3 (Graph API Explorer) and update:
minipostiz auth --platform facebook \
--pageAccessToken "NEW_TOKEN" \
--pageId "YOUR_PAGE_ID"