SoftSolzSoftSolz
Sign up
HomeAPI GuideAPI ReferenceWidget Tester
Social Publishing

List connected social accounts.

List connected social accounts.

GEThttps://app.softsolz.uk/api/v1/services/social/accounts

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Headers

Authorizationstringrequired

Bearer token: `Bearer sk_live_...` (or `sk_test_...` for sandbox). A login token will not work here.

Response

Response Body · array of objects

idstringAccount id (numeric string).
tenant_idstringOwning tenant id.
platformstringConnected platform.
account_kindstringWhether this is a personal profile or a page/business account.
external_idstringId of the account on the platform.
display_namestring | nullDisplay name shown to viewers.
avatar_urlstring | nullAccount avatar image URL.
token_expires_atstring | nullWhen the stored access token expires; null if it does not.
scopesarray of stringsGranted OAuth scopes.
statusstringConnection health.
last_validated_atstring | nullLast time the connection was verified.
last_errorstring | nullLast connection error, if any.
environmentstringEnvironment.
connected_byinteger | nullUser id that connected the account.
visibilitystringWho else in the tenant can use this account.
created_atstringWhen the account was connected.
updated_atstringLast update timestamp.
connected_by_namestring | nullDisplay name of the user that connected the account.
shared_usersarray of objectsUsers the account is shared with, when visibility is "shared".
shared_rolesarray of objectsRoles the account is shared with, when visibility is "shared".
is_ownerbooleanAlways false via the server-to-server API (no viewer context).

Request

curl --request GET \
  --url https://app.softsolz.uk/api/v1/services/social/accounts \
  --header 'Authorization: Bearer sk_live_your_key'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
  "data": [
    {
      "id": "1",
      "tenant_id": "your-tenant-id",
      "platform": "linkedin",
      "account_kind": "profile",
      "external_id": "your-external-id",
      "display_name": "your-display-name",
      "avatar_url": "https://example.com",
      "token_expires_at": "2026-01-01T09:00:00.000Z",
      "scopes": [
        "your-scopes"
      ],
      "status": "active",
      "last_validated_at": "2026-01-01T09:00:00.000Z",
      "last_error": "your-last-error",
      "environment": "live",
      "connected_by": 1,
      "visibility": "private",
      "created_at": "2026-01-01T09:00:00.000Z",
      "updated_at": "2026-01-01T09:00:00.000Z",
      "connected_by_name": "your-connected-by-name",
      "shared_users": [
        {
          "user_id": 1,
          "name": "your-name",
          "email": "person@example.com"
        }
      ],
      "shared_roles": [
        {
          "role_id": 1,
          "role_name": "your-role-name"
        }
      ],
      "is_owner": true
    }
  ],
  "meta": {
    "limit": 50,
    "offset": 0,
    "total": 1,
    "has_more": false
  }
}