Skip to main content

​
Get Started in Three Steps

This guide will help you deploy Postiz, connect your first social platform, and schedule your first post.
1

Deploy Postiz

Choose your deployment method:
Sign up for a free account at platform.postiz.com and skip to Step 2.
The cloud version is immediately ready with no setup required. Perfect for testing Postiz.
2

Create Your Account

On first launch, you’ll be prompted to create an admin account.Required Information:
  • Full name
  • Email address
  • Password (min 8 characters)
If RESEND_API_KEY is configured in your environment, you’ll need to verify your email. Otherwise, accounts are auto-activated.
After creating your account, you’ll land on the main dashboard.
3

Connect Your First Platform

Let’s connect X (Twitter) as your first platform:
  1. Navigate to Settings → Integrations
  2. Click Add Channel
  3. Select X (Twitter) from the platform list
  4. Click Connect with OAuth
# Add these to your .env file before connecting
X_API_KEY="your_twitter_api_key"
X_API_SECRET="your_twitter_api_secret"
Don’t have X API credentials? Follow Twitter’s Developer Portal to create an app and get your keys.
  1. Authorize Postiz to access your X account
  2. Your account will appear in the Connected Channels list
You can connect multiple accounts from the same platform (e.g., personal and business Twitter accounts).
4

Schedule Your First Post

Now let’s create and schedule your first post:
  1. Click the + New Post button in the top navigation
  2. Select your connected X account from the channel selector
  3. Type your post content in the editor
Using AI Content Generation (Optional):If you have OPENAI_API_KEY configured:
  • Click the AI Assist button
  • Enter a topic or prompt
  • Postiz will generate engaging content for you
  1. Set Your Schedule:
    • Click the calendar icon
    • Choose date and time
    • Select your timezone
  2. Preview Your Post:
    • Click Preview to see how it will appear
    • Make any adjustments
  3. Schedule It:
    • Click Schedule Post
    • Your post is now queued!

​
Next Steps

Now that you’ve scheduled your first post, explore these powerful features:

Calendar View

See all scheduled posts in a visual calendar. Drag and drop to reschedule, or click any post to edit.Navigate to Dashboard → Calendar

Connect More Platforms

Expand your reach by connecting LinkedIn, Instagram, Facebook, YouTube, TikTok, and 25+ more platforms.Go to Settings → Integrations

Bulk Scheduling

Upload a CSV with multiple posts to schedule content in bulk. Perfect for planning monthly campaigns.Use the Bulk Upload feature in the calendar

Team Collaboration

Invite team members to collaborate on content. Set up approval workflows and assign roles.Access Settings → Team Management

Analytics Dashboard

Track performance with detailed analytics. See engagement, reach, and growth across all platforms.View Analytics → Overview

Media Library

Organize your assets in the centralized media library. Upload images and videos to reuse across posts.Open Media Library from the sidebar

​
Platform-Specific Setup

Each platform requires its own OAuth credentials. Here are quick setup guides:
Required Credentials:
  • API Key
  • API Secret
Setup Steps:
  1. Go to Twitter Developer Portal
  2. Create a new app
  3. Enable OAuth 2.0
  4. Set callback URL: http://localhost:4007/integrations/social/x (adjust for your domain)
  5. Copy credentials to your .env file
X_API_KEY="your_api_key"
X_API_SECRET="your_api_secret"
Required Credentials:
  • Client ID
  • Client Secret
Setup Steps:
  1. Visit LinkedIn Developers
  2. Create a new app
  3. Add OAuth 2.0 redirect: http://localhost:4007/integrations/social/linkedin
  4. Request access to “Share on LinkedIn” product
LINKEDIN_CLIENT_ID="your_client_id"
LINKEDIN_CLIENT_SECRET="your_client_secret"
Required Credentials:
  • Facebook App ID
  • Facebook App Secret
Setup Steps:
  1. Create a Facebook App
  2. Add Instagram Basic Display product
  3. Add Instagram Graph API
  4. Configure OAuth redirect to your Postiz instance
FACEBOOK_APP_ID="your_app_id"
FACEBOOK_APP_SECRET="your_app_secret"
Instagram requires a Facebook Business Page connected to your Instagram account.
Required Credentials:
  • Google Client ID
  • Google Client Secret
Setup Steps:
  1. Go to Google Cloud Console
  2. Create a new project
  3. Enable YouTube Data API v3
  4. Create OAuth 2.0 credentials
  5. Add redirect: http://localhost:4007/integrations/social/youtube
YOUTUBE_CLIENT_ID="your_client_id"
YOUTUBE_CLIENT_SECRET="your_client_secret"
Required Credentials:
  • Client Key
  • Client Secret
Setup Steps:
  1. Register at TikTok for Developers
  2. Create a new app
  3. Request video publishing permissions
  4. Configure redirect URI
TIKTOK_CLIENT_ID="your_client_key"
TIKTOK_CLIENT_SECRET="your_client_secret"
Full platform list: See installation.mdx for all 30+ supported platforms and their credential requirements.

​
Troubleshooting

Problem: Getting a redirect URI mismatch error when connecting platforms.Solution: Ensure your callback URLs in platform developer consoles match exactly:
# Your .env file
FRONTEND_URL="http://localhost:4007"

# Platform redirect should be:
# http://localhost:4007/integrations/social/{platform_name}
Replace localhost:4007 with your actual domain in production.
Problem: Scheduled posts aren’t being published at the specified time.Solution: Check that Temporal orchestrator is running:
# Check service status
docker compose ps

# Should see 'temporal' service as 'running'
# Check orchestrator logs
docker compose logs orchestrator
The orchestrator handles all background job execution.
Problem: Not receiving verification emails after signup.Solution: If you don’t have Resend configured, disable email verification:
# Remove or comment out in .env
# RESEND_API_KEY="..."
Users will be auto-activated without email verification.

​
Need Help?

Documentation

Browse the full documentation for detailed guides

Discord Community

Join our developer community for support

GitHub Issues

Report bugs or request features

API Reference

Integrate Postiz with custom workflows
Pro Tip: Set up AI content generation with OpenAI to create engaging posts automatically. Just add your OPENAI_API_KEY to the environment variables!

Build docs developers (and LLMs) love

Get started for freeTalk to us