Skip to main content
POST
Connect the social platform this link was issued for

Path Parameters

token
string
required

The 64-character token from the URL the agent sent.

Body

application/json
auth_code
string
required

Authorization code returned by the platform's OAuth redirect.

Example:

"AQD1x..."

redirect_uri
string | null

Must match the URI registered with the platform: https://app.mogl.online/social-link/callback/{instagram|tiktok|x}, with no trailing slash, on the environment's own host. Note X is x in the callback path while the platform is twitter everywhere in this API.

Example:

"https://app.mogl.online/social-link/callback/instagram"

code_verifier
string | null

PKCE verifier. TikTok only.

Example:

"dBjftJeZ4CVP..."

Response

Connected

status
string
Example:

"success"

platform
enum<string>
Available options:
instagram,
tiktok,
twitter
Example:

"instagram"

username
string | null

The account that was just linked, named on the success screen. Null until the platform sync has returned the handle.

Example:

"brandon_wimbush7"