API resource

Accounts

Connected social accounts in the workspace. Supported networks: instagram, tiktok, youtube, twitter (X), threads, facebook, linkedin.

List accounts

GET/v1/accounts

Works on: Instagram, TikTok, YouTube, X, Threads, Facebook, LinkedIn

Every social account connected to the workspace. Use the id values wherever an endpoint asks for accountId.

Query parameters

platformstring

Only accounts on this network, e.g. instagram.

statusstring

connected (healthy) or disconnected (needs reconnecting).

curl "https://creatoros-production-5658.up.railway.app/v1/accounts" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"

Response 200

{
  "accounts": [
    {
      "id": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
      "platform": "instagram",
      "username": "kevbuildsapps",
      "displayName": "Kev Builds Apps",
      "isActive": true
    },
    {
      "id": "acc_Q3n1PvR8dKc0Zb7LwY4sHx2mJt9Eg6Ua5Nf1Ck8Tq3Vz",
      "platform": "tiktok",
      "username": "kevbuildsapps",
      "displayName": "Kev",
      "isActive": true
    }
  ]
}

Check account health

GET/v1/accounts/health

Works on: Instagram, TikTok, YouTube, X, Threads, Facebook, LinkedIn

Token validity and permissions per account, so you can prompt for a reconnect before a post fails.

Query parameters

platformstring

Only accounts on this network.

curl "https://creatoros-production-5658.up.railway.app/v1/accounts/health" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"

Response 200

{
  "summary": {
    "total": 2,
    "healthy": 2,
    "warning": 0,
    "error": 0,
    "needsReconnect": 0
  },
  "accounts": [
    {
      "accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
      "platform": "instagram",
      "username": "kevbuildsapps",
      "status": "healthy",
      "canPost": true,
      "canFetchAnalytics": true,
      "tokenValid": true,
      "tokenExpiresAt": "2026-11-24T00:00:00.000Z",
      "needsReconnect": false,
      "issues": []
    }
  ]
}

Follower stats

GET/v1/accounts/followers

Works on: Instagram, TikTok, YouTube, X, Threads, Facebook, LinkedIn

Follower counts and growth over a date range, with a time series per account. stats is keyed by account id.

Query parameters

fromDateYYYY-MM-DD

Start of the range. Defaults to 30 days ago.

toDateYYYY-MM-DD

End of the range. Defaults to today.

granularitystring

daily, weekly or monthly.

accountIdsstring

Comma-separated account ids. Defaults to all.

curl "https://creatoros-production-5658.up.railway.app/v1/accounts/followers?fromDate=2026-09-01&toDate=2026-09-25&granularity=daily" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"

Response 200

{
  "accounts": [
    {
      "id": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
      "platform": "instagram",
      "username": "kevbuildsapps",
      "currentFollowers": 48210,
      "growth": 1204,
      "growthPercentage": 2.56,
      "dataPoints": 25
    }
  ],
  "stats": {
    "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r": [
      {
        "date": "2026-09-24",
        "followers": 48102
      },
      {
        "date": "2026-09-25",
        "followers": 48210
      }
    ]
  },
  "dateRange": {
    "from": "2026-09-01T00:00:00.000Z",
    "to": "2026-09-25T00:00:00.000Z"
  },
  "granularity": "daily"
}

Check one account

GET/v1/accounts/{accountId}/health

Works on: Instagram, TikTok, YouTube, X, Threads, Facebook, LinkedIn

Health for a single account, with the permissions it was granted and what to fix if it can’t post.

Path parameters

accountIdstringrequired

The acc_ id.

curl "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r/health" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"

Response 200

{
  "accountId": "acc_uwsum2TkX6QB7M2BWX_F2kYykNTaWuC3V2Spge_Xm4r",
  "platform": "instagram",
  "username": "kevbuildsapps",
  "displayName": "Kev Builds Apps",
  "status": "healthy",
  "canPost": true,
  "canFetchAnalytics": true,
  "tokenValid": true,
  "needsReconnect": false,
  "issues": []
}

TikTok creator info

GET/v1/accounts/{accountId}/tiktok/creator-info

Works on: TikTok

What this TikTok creator is allowed to post right now: privacy levels to offer, maximum video length, and whether comments, duets and stitches can be enabled. Check it before building a TikTok post.

Path parameters

accountIdstringrequired

A TikTok acc_ id.

Query parameters

mediaTypestring

video or photo. Affects the interaction settings returned.

curl "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_Q3n1PvR8dKc0Zb7LwY4sHx2mJt9Eg6Ua5Nf1Ck8Tq3Vz/tiktok/creator-info?mediaType=video" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"

Response 200

{
  "creator": {
    "nickname": "creator.os",
    "isVerified": false,
    "canPostMore": true
  },
  "privacyLevels": [
    {
      "value": "PUBLIC_TO_EVERYONE",
      "label": "Everyone"
    },
    {
      "value": "MUTUAL_FOLLOW_FRIENDS",
      "label": "Friends"
    },
    {
      "value": "SELF_ONLY",
      "label": "Only me"
    }
  ],
  "postingLimits": {
    "maxVideoDurationSec": 600,
    "interactionSettings": {
      "allow_comment": {
        "enabled": true,
        "required": true,
        "default": true,
        "label": "Allow comments"
      }
    }
  }
}

Connect an account

GET/v1/connect/{platform}

Works on: Instagram, TikTok, YouTube, X, Threads, Facebook, LinkedIn

Returns a link that starts the network’s own login. Open it in a browser. When the user finishes, they are sent to return_to with connected, account (the new acc_ id) and username appended, or error if they cancelled.

For Facebook the user picks a Page, and for LinkedIn a personal profile or company page, on a Creator OS screen before being returned.

Path parameters

platformstringrequired

instagram, tiktok, youtube, twitter, threads, facebook or linkedin.

Query parameters

return_tourl

Where to send the user afterwards. Must be on creatoros.ca, localhost, or the Creator OS app. Defaults to a Creator OS confirmation page.

curl "https://creatoros-production-5658.up.railway.app/v1/connect/instagram" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"

Response 200

{
  "platform": "instagram",
  "auth_url": "https://www.instagram.com/oauth/authorize?client_id=..."
}

Disconnect an account

DELETE/v1/accounts/{accountId}

Works on: Instagram, TikTok, YouTube, X, Threads, Facebook, LinkedIn

Removes the connection. Scheduled posts to this account will fail, so confirm with the account owner first.

Path parameters

accountIdstringrequired

The acc_ id to disconnect.

curl -X DELETE "https://creatoros-production-5658.up.railway.app/v1/accounts/acc_Q3n1PvR8dKc0Zb7LwY4sHx2mJt9Eg6Ua5Nf1Ck8Tq3Vz" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"

Response 200

{
  "message": "Account disconnected successfully"
}

PreviousWorkspace NextPosts