📱

Postiz Platform Setup Guide

Per-platform intake for connecting social accounts. Enter hub password to continue.

That's not right. Try again.

📱 Postiz Social Scheduler

Platform Setup Guide

What you do vs what Charlie does, per platform  ·  Last updated 2026-06-25

← Back to Hub

How This Works

🟢 You you do it, your login, your developer account, ~5-10 min per platform
🔵 Charlie Charlie does it, server config, automatic after you send the keys

The flow for every platform:

  1. You create the dev app at the portal listed below
  2. You paste in the redirect URI exactly as shown
  3. You copy the Client ID + Secret (or App ID + App Secret)
  4. You send them to Charlie in chat
  5. Charlie wires them into the server and restarts
  6. You click "Connect" in Postiz and authorize with your account
📌

1. Pinterest

Priority: HIGH

Needed for RecipeMemoir + SmartStrongAlive

⚠️ Requires a Pinterest Business/Company Account (not a personal account). If you only have a personal account, convert it first at pinterest.com/business/convert.
🟢 You do
  • Have a Pinterest Business Account (free to create or convert)
  • Go to Pinterest Developer Dashboard and click "Create app"
  • Fill out all required fields (name, description, website URL)
  • Paste the redirect URI below into the app settings
  • Copy the App ID and Secret Key and send to Charlie
🔵 Charlie does
  • Adds PINTEREST_CLIENT_ID and PINTEREST_CLIENT_SECRET to the server .env
  • Restarts Postiz
Redirect / Callback URI, paste this exactly
https://postiz.annettethompson.com/integrations/social/pinterest
What to copy and send Charlie
  • App ID (shown as "App id" in the dashboard)
  • Secret Key (shown as "App secret key" in the dashboard)
Gotchas
  • App requires approval before it works, not instant (can take 1-3 days)
  • You must have a Business Account; the dashboard will block you if you don't
⏱️ ~10 min to create, then 1-3 day approval wait
💼

2. LinkedIn

Priority: MEDIUM

Good for thought leadership and professional content

🟢 You do
  • Any LinkedIn account works (personal is fine)
  • Go to LinkedIn Developers and click "Create app"
  • Associate it with a LinkedIn Company Page (create a placeholder if you don't have one)
  • Paste the redirect URI below into the Auth tab
  • Go to the Products tab, add "Sign In with LinkedIn using OpenID Connect" and "Share on LinkedIn"
  • Request the Advertising API (critical, without it, token refresh breaks and you'll get logged out)
  • Copy Client ID and Client Secret from the Auth tab and send to Charlie
🔵 Charlie does
  • Adds LINKEDIN_CLIENT_ID and LINKEDIN_CLIENT_SECRET to the server .env
  • Restarts Postiz
Redirect / Callback URI, paste this exactly
https://postiz.annettethompson.com/integrations/social/linkedin
⚠️ Critical: Request the Advertising API on the Products tab and fill out the request form. Without it, token refresh won't work and you'll get logged out constantly. LinkedIn may take a few days to approve this.
Note on posting to a LinkedIn Page
If you also want to post to a LinkedIn Page (vs your personal profile), you'll add a second URI with linkedin-page instead of linkedin. Charlie handles that when you're ready.
⏱️ ~15 min to create + add products; Advertising API approval may take 1-5 business days
🤖

3. Reddit

Priority: MEDIUM

Great for niche communities: menopause, fitness, expat forums

🟢 You do
  • Any Reddit account works (your regular account is fine)
  • Go to Reddit App Preferences, scroll down, click "create another app"
  • Name: Something like Postiz-Annette
  • App type: Select "web app" (important, not "installed app" or "script")
  • Paste the redirect URI below
  • Copy the Client ID (short string under the app name) and Client Secret (labeled "secret") and send to Charlie
🔵 Charlie does
  • Adds REDDIT_CLIENT_ID and REDDIT_CLIENT_SECRET to the server .env
  • Restarts Postiz
Redirect / Callback URI, paste this exactly
https://postiz.annettethompson.com/integrations/social/reddit
⚠️ UI quirk: The Client ID is the short string right under the app name (it's not labeled "client id"). The secret is labeled "secret." No review process needed for personal/small-scale use.
⏱️ ~5 minutes, no approval wait
📘

4. Meta (Facebook + Instagram)

Parked, revisit later

Priority: LOW. Complex setup, business verification required. Revisit after the others are running.

Note: One Facebook developer app covers both Facebook and Instagram, you don't need two separate apps.
🟢 You do
  • Facebook account + a Facebook Business Portfolio (free, at business.facebook.com)
  • Go to Facebook Developers App Creation
  • Select your Business Portfolio
  • App type: select "Other", then "Business"
  • Fill out app name and contact email
  • Paste the redirect URI below
  • Set up "Login with Facebook" (a product inside the app) and configure the redirect URI there
  • Copy App ID and App Secret from Basic Settings and send to Charlie
🔵 Charlie does
  • Adds FACEBOOK_APP_ID and FACEBOOK_APP_SECRET to the server .env
  • Restarts Postiz
  • Instagram uses the same values
Redirect / Callback URI, paste this exactly
https://postiz.annettethompson.com/integrations/social/facebook
Permissions you'll need to request
  • pages_show_list
  • business_management
  • pages_manage_posts
  • pages_manage_engagement
  • pages_read_engagement
  • read_insights
These require Meta's review.
⚠️ Business Verification required for public apps. Meta will ask for business documents. For personal/solo use you can stay in Development mode and post to your own accounts, but the app won't work for other users. Must flip app from Development to Live before posts are publicly visible. This whole process can take a week or more if Meta requests review.
⏱️ 30+ min to set up; business verification and permission review can take 1-2 weeks

Status Tracker

Platform Account created Dev app created Keys sent to Charlie Connected in Postiz
YouTube (SEO Believer) ✅ ✅ ✅ ✅
Pinterest in progress in progress - -
LinkedIn not started not started - -
Reddit not started not started - -
Meta (Facebook + Instagram) not started not started - -

Source-verified against Postiz provider docs  ·  Last updated 2026-06-25  ·  Private  ·  ← Hub