Account Connections

If you are running into issues during the authentication flow, it is likely due to a specific platform configuration or project setting.

Here is a breakdown of common connection issues and how to resolve them.

Quickstart Project Redirects

When using a Quickstart project, you are utilizing our system credentials to authenticate users. Because of this, you cannot dynamically override the redirect URL via the API request.

When generating the authentication link via the create-upload-url endpoint, make sure you do not pass the redirect_url_override parameter.

Instead of passing the URL in the code, you can set your global Project Redirect URL inside the Post for Me dashboard settings. The system will automatically redirect to this URL after a successful login.

LinkedIn Connections

LinkedIn requires a specific connection type to enable full functionality for both personal profiles and company pages when using our shared credentials.

When creating the auth URL for a Quickstart project, you must pass "organization" as the connection_type, even if the user is connecting a personal account.

Example

{
  "platform": "linkedin",
  "platform_data": {
    "linkedin": {
      "connection_type": "organization"
    }
  },
  "permissions": [
    "posts",
    "feeds"
  ]
}

Why it matters

This setting tells LinkedIn that we are requesting access via the Community Management API. This specific API allows your application to connect and manage both personal profiles and company pages under a single authentication flow.

Facebook Requirements

Facebook permissions are strictly scoped to business usage. We cannot connect to or post to personal Facebook User Timelines.

During the connection flow, the user will be presented with a list of pages. They must select at least one Facebook page and the associated business to complete the connection.

Note: If a user attempts to connect only a personal profile without selecting a Page, the connection will fail.

Instagram Configuration

Instagram has two specific requirements regarding account types and login methods.

Account Type: The target Instagram account must be converted to a Professional or Creator account. Personal Instagram accounts do not support the API features required for third-party posting.

Connection Type: If you have enabled both "Instagram" and "Instagram (Facebook Login)" in your project settings, the system needs to know which flow to initiate. You must pass the connection_type parameter with a value of either "instagram" or "facebook" to determine which login method is used.

Example

{
  "platform": "instagram",
  "platform_data": {
    "instagram": {
      "connection_type": "instagram"
    }
  },
  "permissions": [
    "posts",
    "feeds"
  ]
}

Bluesky Authentication

Bluesky handles third-party security differently than most platforms. It does not use standard OAuth tokens in the same way; instead, it utilizes app-specific passwords.

The Requirement: When connecting a Bluesky account, you must provide the handle and an App Password.

How it works

Users should not enter their standard login password. They must generate a specific App Password within their Bluesky settings and use that credential to authorize the connection.