← Dashboard Platform Setup Guide 1 / 12 OAuth configured
💼
LinkedIn
Open Developer Portal → Official Docs →
Setup Steps
1
Create a LinkedIn App
Visit the developer portal. Create a new app; set App type = Web.
2
Add OAuth redirect URL
In the Auth tab → OAuth 2.0 settings, paste the callback URL below.
3
Enable products
Add Sign In with LinkedIn using OpenID Connect and Share on LinkedIn products.
4
Copy credentials
From the Auth tab, copy Client ID and Client Secret.
5
Add to Space secrets
Open your HF Space settings, add both env vars below, then restart the Space.
Callback URL Paste this in the developer portal when asked for "Redirect URI" or "Callback URL"
https://somratpro-huggingpost.hf.space/integrations/social/linkedin
Space Secrets to Add HF Space → Settings → Variables & Secrets
LINKEDIN_CLIENT_ID Client ID
NOT SET
LINKEDIN_CLIENT_SECRET Client Secret
NOT SET
Open Space Settings → Variables & Secrets

After adding all secrets, click Restart Space for them to take effect.

🐦
X / Twitter
Open Developer Portal → Official Docs →
Setup Steps
1
Create an X Developer App
Go to developer.twitter.com. Apply for a developer account if needed. Create a new project + app.
2
Configure User Authentication Settings
On your app page → User authentication settings → Set up. Set ALL THREE of these, then click Save:

1. App permissions: Read and write (default is Read-only — must change this)
2. Type of App: Native App (Public client) — ⚠️ NOT Web App, Web App causes error code 32
3. Callback URI: paste the Callback URL shown below. Website URL = your HF Space URL.

Save when done.
3
Regenerate Consumer Keys (required after saving settings)
Go to Keys & Tokens tab → OAuth 1.0 Keys section → click Regenerate next to Consumer Key.

⚠️ You must regenerate after changing User Auth Settings — existing keys don't pick up new permissions.

The Regenerate popup shows BOTH values together — copy them immediately:
• API Key = your X_API_KEY
• API Key Secret = your X_API_SECRET

⚠️ Do NOT use Bearer Token, Access Token/Secret, or OAuth 2.0 Client ID/Secret.
4
Add to Space secrets and restart
Add X_API_KEY and X_API_SECRET to HF Space → Settings → Variables & Secrets. Then Restart the Space to load the new values.
Callback URL Paste this in the developer portal when asked for "Redirect URI" or "Callback URL"
https://somratpro-huggingpost.hf.space/integrations/social/x
Space Secrets to Add HF Space → Settings → Variables & Secrets
X_API_KEY API Key (Consumer Key)
SET
X_API_SECRET API Secret (Consumer Secret)
SET
Open Space Settings → Variables & Secrets

After adding all secrets, click Restart Space for them to take effect.

📘
Facebook
Open Developer Portal → Official Docs →
Setup Steps
1
Create a Meta App
Go to Meta for Developers. Create a new app with use case Authenticate and request data from users.
2
Add Facebook Login product
In the app dashboard, click Add Product → Facebook Login → Web.
3
Add callback URL
In Facebook Login settings → Valid OAuth Redirect URIs, paste the callback URL below.
4
Request permissions
Add pages_manage_posts, pages_read_engagement, publish_to_groups permissions.
5
Copy credentials
From App Settings → Basic, copy App ID and App Secret.
6
Add to Space secrets
Add both env vars below to your HF Space settings, then restart.
Callback URL Paste this in the developer portal when asked for "Redirect URI" or "Callback URL"
https://somratpro-huggingpost.hf.space/integrations/social/facebook
Space Secrets to Add HF Space → Settings → Variables & Secrets
FACEBOOK_APP_ID App ID
NOT SET
FACEBOOK_APP_SECRET App Secret
NOT SET
Open Space Settings → Variables & Secrets

After adding all secrets, click Restart Space for them to take effect.

📸
Instagram
Open Developer Portal → Official Docs →
Setup Steps
1
Use the Facebook app
Instagram uses the same Meta app as Facebook — configure Facebook first.
2
Add Instagram Graph API product
In your Meta app dashboard, click Add Product → Instagram Graph API.
3
Connect an Instagram Business account
Your Instagram account must be a Professional (Business or Creator) account linked to a Facebook Page.
4
Add callback URL
In Instagram Login settings → Valid OAuth Redirect URIs, paste the callback URL below.
5
No extra env vars needed
Instagram and Facebook share FACEBOOK_APP_ID and FACEBOOK_APP_SECRET.
Callback URL Paste this in the developer portal when asked for "Redirect URI" or "Callback URL"
https://somratpro-huggingpost.hf.space/integrations/social/instagram
Space Secrets to Add HF Space → Settings → Variables & Secrets
FACEBOOK_APP_ID App ID (same as Facebook app)
NOT SET
FACEBOOK_APP_SECRET App Secret (same as Facebook app)
NOT SET
Open Space Settings → Variables & Secrets

After adding all secrets, click Restart Space for them to take effect.

🧵
Threads
Open Developer Portal → Official Docs →
Setup Steps
1
Create a Meta App
Create a Meta Developer app (separate from Facebook/Instagram if you prefer clean separation).
2
Add Threads API product
In the app dashboard, click Add Product → Threads API.
3
Add callback URL
In Threads API settings → Redirect URI, paste the callback URL below.
4
Copy credentials
From App Settings → Basic, copy App ID and App Secret.
5
Add to Space secrets
Add both env vars below to your HF Space settings, then restart.
Callback URL Paste this in the developer portal when asked for "Redirect URI" or "Callback URL"
https://somratpro-huggingpost.hf.space/integrations/social/threads
Space Secrets to Add HF Space → Settings → Variables & Secrets
THREADS_APP_ID App ID
NOT SET
THREADS_APP_SECRET App Secret
NOT SET
Open Space Settings → Variables & Secrets

After adding all secrets, click Restart Space for them to take effect.

🔵
Google Login
Open Developer Portal → Official Docs →
Setup Steps
1
Create a Google Cloud project
Go to console.cloud.google.com. Create a new project (or use an existing one).
2
Configure OAuth consent screen
In APIs & Services → OAuth consent screen, set User Type to External. Fill app name, support email, developer email. Add scopes: email, profile, openid. Add your own Google account as a test user.
3
Create OAuth 2.0 credentials
In APIs & Services → Credentials, click Create Credentials → OAuth client ID. Set type to Web application. Name it HuggingPost.
4
Add callback URLs
Under Authorized redirect URIs, add the callback URL below. Also add the YouTube callback URL if you plan to connect YouTube — it is shown on the YouTube tab.
5
Copy credentials
Copy the Client ID and Client Secret shown in the dialog.
6
Add to Space secrets
Add GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET to HF Space → Settings → Variables & Secrets. Restart the Space.

💡 These same credentials also power YouTube channel connections — no separate YouTube OAuth app needed.
Callback URL Paste this in the developer portal when asked for "Redirect URI" or "Callback URL"
https://somratpro-huggingpost.hf.space/integrations/social/google
Space Secrets to Add HF Space → Settings → Variables & Secrets
GOOGLE_CLIENT_ID OAuth 2.0 Client ID
NOT SET
GOOGLE_CLIENT_SECRET OAuth 2.0 Client Secret
NOT SET
Open Space Settings → Variables & Secrets

After adding all secrets, click Restart Space for them to take effect.

▶️
YouTube
Open Developer Portal → Official Docs →
Setup Steps
1
Already set up Google Login?
✅ Skip to Step 2. YouTube uses the same GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET — no new OAuth app needed. Just enable the YouTube API and add the callback URL.
2
Enable YouTube Data API v3
In APIs & Services → Library, search for YouTube Data API v3 and click Enable.
3
Add YouTube callback URL to your OAuth client
In Credentials → your OAuth client → Edit, add the callback URL below to Authorized redirect URIs. Save.
4
Add YouTube scopes to consent screen
In OAuth consent screen → Edit App → Scopes, add https://www.googleapis.com/auth/youtube.upload and https://www.googleapis.com/auth/youtube.
5
First time setup only: add GOOGLE_* secrets
If you haven't done Google Login yet — add GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET to HF Space secrets and restart. If Google Login is already working, no new secrets needed.
Callback URL Paste this in the developer portal when asked for "Redirect URI" or "Callback URL"
https://somratpro-huggingpost.hf.space/integrations/social/youtube
Space Secrets to Add HF Space → Settings → Variables & Secrets
GOOGLE_CLIENT_ID OAuth 2.0 Client ID (same as Google Login)
NOT SET
GOOGLE_CLIENT_SECRET OAuth 2.0 Client Secret (same as Google Login)
NOT SET
Open Space Settings → Variables & Secrets

After adding all secrets, click Restart Space for them to take effect.

🎵
TikTok
Open Developer Portal → Official Docs →
Setup Steps
1
Apply for TikTok Developer access
Sign in at developers.tiktok.com. Apply for developer access (may take 1-2 days).
2
Create an app
Create a new app. Set Platform: Web.
3
Add Login Kit
Add Login Kit product. This enables OAuth for your app.
4
Add callback URL
In Login Kit settings → Redirect domain, add your HF Space hostname. In redirect URI, paste the callback URL below.
5
Request Content Posting API
Add Content Posting API product for posting videos/photos.
6
Copy credentials
From app overview, copy Client Key (as CLIENT_ID) and Client Secret.
7
Add to Space secrets
Add both env vars below to your HF Space settings, then restart.
Callback URL Paste this in the developer portal when asked for "Redirect URI" or "Callback URL"
https://somratpro-huggingpost.hf.space/integrations/social/tiktok
Space Secrets to Add HF Space → Settings → Variables & Secrets
TIKTOK_CLIENT_ID Client Key
NOT SET
TIKTOK_CLIENT_SECRET Client Secret
NOT SET
Open Space Settings → Variables & Secrets

After adding all secrets, click Restart Space for them to take effect.

🤖
Reddit
Open Developer Portal → Official Docs →
Setup Steps
1
Go to Reddit App Preferences
Visit reddit.com/prefs/apps while logged in.
2
Create a new app
Click create another app…. Set type to web app.
3
Add callback URL
In the redirect uri field, paste the callback URL below.
4
Copy credentials
The Client ID is the string below the app name. Client Secret is labelled "secret".
5
Add to Space secrets
Add both env vars below to your HF Space settings, then restart.
Callback URL Paste this in the developer portal when asked for "Redirect URI" or "Callback URL"
https://somratpro-huggingpost.hf.space/integrations/social/reddit
Space Secrets to Add HF Space → Settings → Variables & Secrets
REDDIT_CLIENT_ID Client ID (under app name)
NOT SET
REDDIT_CLIENT_SECRET Secret
NOT SET
Open Space Settings → Variables & Secrets

After adding all secrets, click Restart Space for them to take effect.

📌
Pinterest
Open Developer Portal → Official Docs →
Setup Steps
1
Create a Pinterest App
Go to Pinterest Developer Portal and create a new app.
2
Add redirect URI
In app settings, add the callback URL below as a redirect URI.
3
Request scopes
Request boards:read, pins:read, pins:write scopes.
4
Copy credentials
Copy App ID and App Secret from the app settings.
5
Add to Space secrets
Add both env vars below to your HF Space settings, then restart.
Callback URL Paste this in the developer portal when asked for "Redirect URI" or "Callback URL"
https://somratpro-huggingpost.hf.space/integrations/social/pinterest
Space Secrets to Add HF Space → Settings → Variables & Secrets
PINTEREST_CLIENT_ID App ID
NOT SET
PINTEREST_CLIENT_SECRET App Secret
NOT SET
Open Space Settings → Variables & Secrets

After adding all secrets, click Restart Space for them to take effect.

🎮
Discord
Open Developer Portal → Official Docs →
Setup Steps
1
Create a Discord Application
Go to Discord Developer Portal → New Application.
2
Add redirect URL
In OAuth2 → Redirects, paste the callback URL below.
3
Create a Bot
In the Bot section, create a bot. Enable Message Content Intent.
4
Copy credentials
Copy Client ID and Client Secret from OAuth2 tab. Copy Bot Token from Bot tab.
5
Add to Space secrets
Add all three env vars below to your HF Space settings, then restart.
Callback URL Paste this in the developer portal when asked for "Redirect URI" or "Callback URL"
https://somratpro-huggingpost.hf.space/integrations/social/discord
Space Secrets to Add HF Space → Settings → Variables & Secrets
DISCORD_CLIENT_ID Application ID
NOT SET
DISCORD_CLIENT_SECRET Client Secret
NOT SET
DISCORD_BOT_TOKEN_ID Bot Token
NOT SET
Open Space Settings → Variables & Secrets

After adding all secrets, click Restart Space for them to take effect.

💬
Slack
Open Developer Portal → Official Docs →
Setup Steps
1
Create a Slack App
Go to api.slack.com/apps → Create New App → From scratch.
2
Add OAuth redirect URL
In OAuth & Permissions → Redirect URLs, paste the callback URL below.
3
Add Bot Token Scopes
Under Bot Token Scopes, add: channels:join, chat:write, channels:read, groups:read.
4
Install to workspace
Click Install to Workspace to generate tokens.
5
Copy credentials
From Basic Information: App Credentials has Client ID, Client Secret, Signing Secret.
6
Add to Space secrets
Add all three env vars below to your HF Space settings, then restart.
Callback URL Paste this in the developer portal when asked for "Redirect URI" or "Callback URL"
https://somratpro-huggingpost.hf.space/integrations/social/slack
Space Secrets to Add HF Space → Settings → Variables & Secrets
SLACK_ID Client ID
NOT SET
SLACK_SECRET Client Secret
NOT SET
SLACK_SIGNING_SECRET Signing Secret
NOT SET
Open Space Settings → Variables & Secrets

After adding all secrets, click Restart Space for them to take effect.

🦋
Bluesky
Official Docs →
Setup Steps
1
Create a Bluesky account
Sign up at bsky.app if you don't have one. Custom PDS users: use your own instance URL.
2
Generate an App Password
In Bluesky → Settings → Privacy and Security → App Passwords → Add App Password. Name it HuggingPost. Copy the generated password — it's shown only once.
3
Open Postiz Integrations
Click the button below to go to Postiz → click Connect next to Bluesky.
4
Fill in credentials
Service: https://bsky.social (or your instance URL)
Identifier: your full handle (e.g. yourname.bsky.social)
Password: the App Password from Step 2 — not your login password.
5
Click Connect
Postiz authenticates and adds your Bluesky account. You can post immediately.
Fields Required in Postiz
Service Default for bsky.social users. Custom instance: use your instance URL.
READY
Identifier Your full Bluesky handle.
READY
Password NOT your login password — generate a dedicated App Password in Bluesky settings.
READY
Open Postiz Integrations →

Click Connect next to Bluesky in Postiz, fill in the credentials above.

🐘
Mastodon
Official Docs →
Setup Steps
1
Find your Mastodon instance URL
Check your profile URL — it's the domain part (e.g. mastodon.social, fosstodon.org).
2
Open Postiz Integrations
Click the button below → click Connect next to Mastodon.
3
Fill in credentials
Service: your full instance URL with https (e.g. https://mastodon.social)
Identifier: your username (the part before @instance)
Password: your account password.
4
Click Connect
Postiz will authenticate via Mastodon's API and add your account.
Fields Required in Postiz
Service Your Mastodon instance URL (e.g. https://fosstodon.org).
READY
Identifier Your username without the @instance part.
READY
Password Your Mastodon account password.
READY
Open Postiz Integrations →

Click Connect next to Mastodon in Postiz, fill in the credentials above.

✈️
Telegram
Official Docs →
Setup Steps
1
Create a Telegram Bot
Open Telegram → message @BotFather → send /newbot → follow prompts → copy the Bot Token (format: 123456789:ABC-...).
2
(Optional) Add bot to a channel
To post to a Telegram channel: add your bot as an Admin of the channel with post permission.
3
Open Postiz Integrations
Click the button below → click Connect next to Telegram.
4
Enter Bot Token
Paste your Bot Token from @BotFather. Click Connect.
Fields Required in Postiz
Bot Token From @BotFather. Format: number:string.
READY
Open Postiz Integrations →

Click Connect next to Telegram in Postiz, fill in the credentials above.

💻
Dev.to
Official Docs →
Setup Steps
1
Log in to Dev.to
Go to dev.to and sign in.
2
Generate an API key
Go to Settings → Extensions → DEV API Keys. Enter a description (e.g. HuggingPost) and click Generate API Key. Copy the key.
3
Open Postiz Integrations
Click the button below → click Connect next to Dev.to.
4
Enter API key
Paste your API key. Click Connect.
Fields Required in Postiz
API Key From dev.to → Settings → Extensions → DEV API Keys.
READY
Open Postiz Integrations →

Click Connect next to Dev.to in Postiz, fill in the credentials above.

📰
Hashnode
Official Docs →
Setup Steps
1
Log in to Hashnode
Go to hashnode.com and sign in.
2
Generate a Personal Access Token
Go to Account Settings → Developer → Personal Access Token → Generate new token. Name it HuggingPost. Copy the token.
3
Open Postiz Integrations
Click the button below → click Connect next to Hashnode.
4
Enter token
Paste your Personal Access Token. Click Connect.
Fields Required in Postiz
Personal Access Token From hashnode.com → Account Settings → Developer → Personal Access Token.
READY
Open Postiz Integrations →

Click Connect next to Hashnode in Postiz, fill in the credentials above.

🔑
Nostr
Official Docs →
Setup Steps
1
Get a Nostr keypair
Use a Nostr client like Snort or Primal to create or export your keys. You need the private key in nsec1... format.
2
⚠️ Security note
Your private key controls your entire Nostr identity. Only enter it in trusted apps. HuggingPost is self-hosted — your key stays in your container.
3
Open Postiz Integrations
Click the button below → click Connect next to Nostr.
4
Enter private key
Paste your nsec1... private key. Click Connect.
Fields Required in Postiz
Private Key Your Nostr private key in nsec (bech32) format.
READY
Open Postiz Integrations →

Click Connect next to Nostr in Postiz, fill in the credentials above.

🐾
Lemmy
Official Docs →
Setup Steps
1
Find your Lemmy instance
You need the full URL of your Lemmy instance (e.g. https://lemmy.world, https://lemmy.ml). Find it at join-lemmy.org.
2
Open Postiz Integrations
Click the button below → click Connect next to Lemmy.
3
Fill in credentials
Instance: your instance URL
Username: your account username
Password: your account password.
4
Click Connect
Postiz authenticates via Lemmy's API.
Fields Required in Postiz
Instance Your Lemmy instance URL.
READY
Username Your Lemmy username.
READY
Password Your Lemmy account password.
READY
Open Postiz Integrations →

Click Connect next to Lemmy in Postiz, fill in the credentials above.

🟣
Warpcast
Official Docs →
Setup Steps
1
Find your FID
Your Farcaster ID (FID) is a numeric value. In Warpcast → Profile → the number in your profile URL, or use farcaster.xyz to look it up.
2
Export your private key
In Warpcast → Settings → Advanced → Recovery phrase, or use a Farcaster tool to derive your custody private key. The key is in hex format (0x...).
3
Open Postiz Integrations
Click the button below → click Connect next to Warpcast.
4
Enter FID and private key
Paste your FID and private key. Click Connect.
Fields Required in Postiz
FID Your Farcaster user ID (numeric).
READY
Private Key Your Farcaster custody private key (hex, 0x-prefixed).
READY
Open Postiz Integrations →

Click Connect next to Warpcast in Postiz, fill in the credentials above.