PostDrip connects to your social media accounts through each platform's official API. For publishing to work reliably — especially for video content — each platform has specific verification and setup requirements. This guide walks you through what's needed for every platform PostDrip supports.

Facebook

Facebook publishing works through Facebook Pages, not personal profiles. You'll need:

  1. A Facebook Page for your business. If you don't have one, create it at facebook.com/pages/create.
  2. Admin access to the Page. You must be a Page admin — editor or moderator access is not sufficient for API publishing.
  3. A confirmed email address on your personal Facebook account that manages the Page.

When you connect Facebook in PostDrip, you'll be asked to log in and grant permissions. Make sure to select the correct Page if you manage multiple Pages. PostDrip needs the pages_manage_posts permission to publish text, image, and video content to your Page.

Troubleshooting Facebook

  • If your Page doesn't appear during connection, check that you have admin access in Page Settings > Page Roles.
  • If publishing fails with a permissions error, try disconnecting and reconnecting the Page. Facebook tokens expire after about 60 days and may need to be refreshed.
  • Business Pages under a Meta Business Suite portfolio may require additional approval in the Business Settings.

Instagram

Instagram publishing requires a Professional account (Business or Creator), not a personal account. Here's how to set it up:

  1. Switch to a Professional account. Open the Instagram app, go to Settings > Account > Switch to Professional Account. Choose either Business or Creator.
  2. Connect to a Facebook Page. Instagram's API requires your Instagram account to be linked to a Facebook Page. During the Professional account setup, you'll be prompted to connect or create a Facebook Page.
  3. Verify your email address in Instagram Settings > Account > Personal Information.

PostDrip publishes images as regular posts and videos as Instagram Reels. Both require a publicly accessible media URL, which PostDrip handles automatically through cloud storage.

Troubleshooting Instagram

  • If you see "Missing Instagram credentials," make sure your account is a Business or Creator account, not a personal one.
  • If the Instagram container status shows "ERROR" after publishing, the issue is usually with the media format. PostDrip generates content in Instagram's required formats, but if you notice failures, check that your account doesn't have any restrictions.
  • Instagram tokens expire after 60 days. If publishing stops working, reconnect your account in PostDrip.

X (formerly Twitter)

X publishing uses OAuth 2.0 with PKCE. You'll need:

  1. An X account with a verified email address. Go to Settings > Your Account > Account Information > Email to confirm.
  2. No posting restrictions. New accounts or accounts flagged for unusual activity may have temporary restrictions that prevent API publishing.

When you connect X in PostDrip, you'll authorize through X's official OAuth flow. PostDrip requests tweet.write and media.write permissions for text, image, and video publishing.

Troubleshooting X

  • If your token expires, PostDrip will attempt to refresh it automatically. If that fails, reconnect in PostDrip.
  • X has rate limits on posting. If you see "rate limit exceeded" errors, wait a few minutes and try again.
  • Video uploads on X require server-side processing which can take up to 30 seconds. This is normal.

Bluesky

Bluesky uses app passwords for third-party access rather than OAuth. Here's the setup:

  1. Confirm your email address. Log into bsky.app, go to Settings > Account > Email, and make sure your email is confirmed. This is especially important for video publishing — Bluesky requires a confirmed email before allowing video uploads.
  2. Create an app password. In Bluesky, go to Settings > App Passwords > Add App Password. Give it a name like "PostDrip" and copy the generated password.
  3. Enter your handle and app password in PostDrip when connecting Bluesky.

Important: Use an app password, not your main account password. App passwords can be revoked individually without changing your login credentials.

Troubleshooting Bluesky

  • If video publishing fails with "unconfirmed_email," log into bsky.app and confirm your email address in Settings > Account.
  • If authentication fails, generate a new app password and update it in PostDrip. App passwords don't expire, but they can be revoked.
  • Bluesky has a 50MB limit for videos and a 1MB limit for images. PostDrip automatically compresses images to fit within limits.

Mastodon

Mastodon is a federated network, so the setup depends on which Mastodon instance (server) your account is on:

  1. Know your instance URL. Your Mastodon handle looks like @username@instance.social. The part after the second @ is your instance URL (e.g., mastodon.social, fosstodon.org).
  2. Verify your email. Most Mastodon instances require email verification during signup. If you skipped this, check your instance's settings page.
  3. Authorize PostDrip. When you connect Mastodon in PostDrip, you'll enter your instance URL. PostDrip registers as an app on your instance and redirects you to authorize through the standard OAuth flow.

Troubleshooting Mastodon

  • If your instance URL isn't recognized, make sure you're entering just the domain (e.g., mastodon.social) without the @username@ prefix.
  • Some smaller Mastodon instances may have custom rate limits or media size restrictions that differ from the defaults. If uploads fail, check your instance's about page for limits.
  • Mastodon supports video uploads natively. Videos under 40MB are generally accepted on most instances.

LinkedIn

LinkedIn publishing works through your personal profile or a LinkedIn Company Page:

  1. Verify your email in LinkedIn Settings > Sign in & Security > Email Addresses.
  2. For Company Pages: You must be a Super Admin of the page to authorize publishing. Check this in your Page's Admin tools.
  3. Authorize PostDrip through LinkedIn's OAuth flow when connecting.

Troubleshooting LinkedIn

  • If your Company Page doesn't appear, verify you have Super Admin access, not just Content Admin or Analyst.
  • LinkedIn tokens expire after 60 days. Reconnect if publishing stops working.

Pinterest

Pinterest publishing creates Pins on a specific board:

  1. Switch to a Business account at business.pinterest.com. You can convert a personal account or create a new business account.
  2. Create at least one board where PostDrip should publish Pins.
  3. Authorize PostDrip through Pinterest's OAuth flow and select the board to publish to.

Troubleshooting Pinterest

  • Pinterest requires a Business account — personal accounts cannot use the publishing API.
  • Pins require an image. PostDrip always generates an image for each post, so this is handled automatically.

TikTok

TikTok publishing uses their Content Posting API:

  1. Have a TikTok account with a verified email or phone number. Check this in TikTok Settings > Account > Email/Phone.
  2. Authorize PostDrip through TikTok's OAuth flow when connecting.
  3. Set your privacy preferences. TikTok may default published content to private visibility depending on your account settings. You can adjust this in your TikTok privacy settings.

Troubleshooting TikTok

  • If published content doesn't appear publicly, check your TikTok privacy settings. The API respects your account's default privacy level.
  • TikTok requires media to be accessible via URL. PostDrip handles this through cloud storage.

General Tips

  • Always use the same browser session when connecting platforms in PostDrip. Some OAuth flows can fail if you're logged into multiple accounts.
  • Check your email verification on every platform before connecting. Most API publishing features require a confirmed email, even if the platform lets you post manually without one.
  • Reconnect if publishing stops. Most platform tokens expire after 30-90 days. If posts start failing after weeks of working fine, disconnecting and reconnecting the platform in PostDrip usually fixes it.
  • One account per platform per PostDrip agent. If you manage multiple accounts on the same platform, create separate agents for each.