Skip to main content
POST
Creates a link where a person connects social accounts of one platform to your workspace. They don’t need a PostSyncer login: they open the link, sign in to the platform and pick the accounts to add. Use it to connect your own account on another device, or send it to a client who owns the account. It is the same link as Accounts → Invite in the app.
  • One link is for one platform.
  • It works for one connect (one sign-in, any of that sign-in’s accounts), then stops.
  • It expires after 7 days (expires_at).
Requires the accounts:create permission, and a workspace role that can add accounts (owner or manager). At your plan’s account limit the request is refused with plan_limit_reached and an upgrade_url instead of a link that would fail after the person signs in. The MCP tool create-account-connect-link does the same.

Request

integer
required
The workspace the accounts are added to. See List Workspaces.
string
required
The platform: twitter (X), linkedin, instagram, facebook, tiktok, youtube, threads, pinterest, bluesky, telegram, mastodon or google_business (Google Business Profile).
string
Mastodon only, and required for it: the server the account is on, e.g. mastodon.social.

Response

string
The page the person opens to connect. Send it as a link.
string
The platform the link connects.
integer
The workspace the accounts are added to.
string | null
Mastodon only: the server the link signs in to.
string
When the link stops working (ISO 8601).
Once the person has connected, the accounts show up in List Accounts.

Error Codes

Unauthorized
Missing or invalid API token
Forbidden
The token does not have the accounts:create permission, your role in the workspace cannot add accounts, or the plan’s account limit is reached (plan_limit_reached)
Unprocessable Entity
A workspace you are not in, a platform a link cannot connect, or Mastodon without mastodon_instance