List social accounts

GET

social

accounts

curl --request GET \
  --url https://api.smartlyq.com/v1/social/accounts \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": [
    {
      "id": 123,
      "platform": "<string>",
      "name": "<string>"
    }
  ],
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Authorizations

Authorization

string

header

required

API key from Developer dashboard (Bearer token).

Response

List of social accounts

success

enum<boolean>

Available options:

true

data

object[]

Show child attributes

meta

object

Show child attributes

Start headless account connectionBegin 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`.

List social accounts

curl --request GET \
  --url https://api.smartlyq.com/v1/social/accounts \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": [
    {
      "id": 123,
      "platform": "<string>",
      "name": "<string>"
    }
  ],
  "meta": {
    "request_id": "<string>",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}