List connected platforms

GET

/public/v1/platforms

const url = 'https://api.loomta.com/public/v1/platforms';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.loomta.com/public/v1/platforms \
  --header 'Authorization: Bearer <token>'

Returns the workspace’s connected, ready-to-post social accounts. Disabled accounts and accounts that need re-authentication are omitted.

Authorizations

apiKey

Responses

200

The connected platforms.

application/json

object

platforms

required

Array<object>

object

string format: uuid

provider

Currently only tiktok is offered.

string

Allowed values: tiktok instagram threads

providerName

string

providerAccountId

string

displayName

string | null

displayHandle

string | null

displayImageUrl

string | null

disabled

boolean

refreshNeeded

boolean

tokenExpiresAt

string | null format: date-time

capabilities

Array<string>

metadata

object

key

additional properties

any

settings

object

key

additional properties

any

Example

{
  "platforms": [
    {
      "provider": "tiktok",
      "providerName": "TikTok",
      "displayHandle": "@myhandle"
    }
  ]
}

401

The API key is missing or invalid.

application/json

object

code

required

A stable, machine-readable error code to branch on.

string

message

required

A human-readable description.

string

details

Optional structured detail (for example Zod validation issues).

Examples

{
  "code": "missing_api_key",
  "message": "A Bearer API key is required."
}

{
  "code": "invalid_api_key",
  "message": "The API key is invalid."
}