Accounts

Start headless account connection

Begin connecting a NEW social account from your own UI (no SmartlyQ dashboard session needed). Returns a one-time connect_url (valid 15 minutes) — open it in a browser so the user can authorize. After they approve, the platform’s OAuth callback completes the connection and (if provided) redirects to return_url with ?connected=<count>&platform=<name>. Supported on all platforms. Platforms that expose multiple targets (YouTube channels, Google Business locations, Tumblr blogs, LinkedIn pages) connect them all automatically. Poll completion with GET /social/connect/{state_token}. Requires scope social:write.

POST

social

connect

{platform}

Start headless account connection

curl --request POST \
  --url https://api.smartlyq.com/v1/social/connect/{platform} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "return_url": "<string>"
}
'

{
  "success": true,
  "data": {
    "platform": "<string>",
    "connect_url": "<string>",
    "expires_at": "2023-11-07T05:31:56Z"
  },
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Authorizations

Authorization

string

header

required

API key from Developer dashboard (Bearer token).

Path Parameters

platform

enum<string>

required

Platform to connect. All 13 platforms are supported (use twitter for X, gmb for Google Business).

Available options:

facebook,

instagram,

twitter,

linkedin,

youtube,

tiktok,

threads,

bluesky,

pinterest,

reddit,

snapchat,

tumblr,

gmb

Body

application/json

return_url

string<uri>

Optional URL to redirect the user to after they finish authorizing.

Response

Connection link created

success

enum<boolean>

Available options:

true

data

object

Show child attributes

meta

object

Show child attributes

Poll headless connection statusPoll whether a headless connection finished, using the `state_token` embedded in the `connect_url` returned by `POST /social/connect/{platform}`. Useful when your app can't observe the `return_url` redirect (server-to-server, or the user closed the tab). Verifies the signed token and reports `connected` (with the new account), `pending`, or `expired`. Requires scope `social:read`.

Start headless account connection

curl --request POST \
  --url https://api.smartlyq.com/v1/social/connect/{platform} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "return_url": "<string>"
}
'

{
  "success": true,
  "data": {
    "platform": "<string>",
    "connect_url": "<string>",
    "expires_at": "2023-11-07T05:31:56Z"
  },
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}