ORorshot
Social

Create a Connect Link

Changed on

Get a one-time link that lets someone connect a social account to your workspace without logging in to Orshot

Available only to Enterprise-plan workspaces and first-party clients.

post/social/connect-sessions

Request

  • Base URL
    https://api.orshot.com/v1
  • URL
    https://api.orshot.com/v1/social/connect-sessions
  • Auth
    HTTP bearer

Request body

platformstring required

One of twitter, instagram, facebook, linkedin, tiktok, youtube, pinterest, reddit, threads. Other platforms are connected from the dashboard.

return_urlstring

Where the person's browser goes once the connection has an outcome. https only, up to 512 characters, no credentials or fragment. The host must be one of your workspace's allowed domains (Embed settings) or orshot.com. Without it the person sees Orshot's own result page.

external_idstring

Your reference for the person or account, up to 128 characters of letters, digits, _, ., : or -. Stored on the connected account and returned by List Social Accounts. Do not put emails or other personal data in it.

reconnect_account_idinteger

An existing account of this workspace and platform. The login is pinned to that account's identity; signing in as anyone else fails with account_mismatch.

expected_usernamestring

The handle the person must sign in with. Any other identity fails with account_mismatch.

post_idinteger

A waiting post of this workspace. Echoed back on the session; waiting posts for the platform attach to the new account on their own.

Response

Successful response

object required

Changes