List connected social accounts.

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

Recent Requests

TimeStatusUser Agent

Make a request to see history.

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

import { SoftSolz } from '@softsolz/sdk';

const client = new SoftSolz({ apiKey: process.env.SOFTSOLZ_API_KEY });

const result = await client.social.listAccounts({});
console.log(result);

Credentials

Authorization

Sent as a Bearer token. Stored only in your browser.

Response · 200

{
  "data": [
    {
      "id": "string",
      "tenant_id": "string",
      "platform": "string",
      "account_kind": "string",
      "external_id": "string",
      "display_name": "string",
      "avatar_url": "string",
      "token_expires_at": "string",
      "scopes": [],
      "status": "string",
      "last_validated_at": "string",
      "last_error": "string",
      "environment": "string",
      "connected_by": 0,
      "visibility": "string",
      "created_at": "string",
      "updated_at": "string",
      "connected_by_name": "string",
      "shared_users": [],
      "shared_roles": [],
      "is_owner": true
    }
  ]
}