Profiles

Profiles are your channel cards — each has its own connected TikTok, YouTube and Instagram accounts (up to 100 profiles per account).

List profiles

GET /v1/profiles

Returns all profiles in your account, including connected channels for each.

Example

curl https://storyload.io/v1/profiles \
  -H "Authorization: Bearer sl_live_xxx"

Response

{
  "profiles": [
    {
      "id": "abc123",
      "name": "Travel Vlogs",
      "created_at": "2026-03-01T12:00:00.000Z",
      "channels": [
        {
          "platform": "tiktok",
          "account_name": "my_travel_acc",
          "account_id": "tt_open_id_xxx",
          "connected_at": "2026-03-02T10:00:00.000Z"
        }
      ]
    }
  ],
  "total": 1
}

Get profile

GET /v1/profiles/:id

Returns a single profile by ID with its connected channels.

Path parameters

Parameter	Type	Required	Description
id	string	yes	Profile ID (from List profiles)

Example

curl https://storyload.io/v1/profiles/PROFILE_ID \
  -H "Authorization: Bearer sl_live_xxx"