API resource

Skool communities

Read and manage the Skool account and communities you connected on the Connect page in Creator OS (you sign in on Skool's own page; Creator OS never sees your password). Only communities you chose to share are reachable; any other slug returns 403 community_not_granted. Each shared community is read only or read & write: writes to a read-only one return 403 community_read_only. Admin reads (join requests, emails, revenue, growth, charts, engagement) need you to own or admin the community, otherwise 403 admin_only. If the Skool session expires, calls return 409 skool_reconnect_required until you reconnect. The Skool guide covers access, limits and every tool in one place.

List connected communities

GET/v1/skool

The Skool account connected to this workspace and the communities you shared with agents. Use a community's slug in the calls below.

curl "https://creatoros-production-5658.up.railway.app/v1/skool" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "account": {
    "name": "Kev Builds",
    "username": "kev-builds",
    "status": "active",
    "sessionExpiresAt": "2027-09-28T20:35:53Z"
  },
  "communities": [
    {
      "id": "9f2c1e0a7b8d4c3e",
      "slug": "creatoros-university",
      "name": "Creator OS University",
      "role": "owner",
      "access": "read_write"
    }
  ]
}

Profile and follower count

GET/v1/skool/profile

The connected Skool profile: followers, following, posts. This follower count also joins your other platforms in the Creator OS dashboard total.

curl "https://creatoros-production-5658.up.railway.app/v1/skool/profile" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "username": "kevbuildsapps",
  "name": "Kev Builds Apps",
  "followers": 2683,
  "following": 21,
  "posts": 491,
  "url": "https://www.skool.com/@kevbuildsapps"
}

Followers

GET/v1/skool/followers

People who follow the connected profile, 30 per page: username, name, bio, avatar, social links and youFollow (whether you follow them back). Skool doesn't expose follower emails. GET /v1/skool/following lists who you follow, same shape.

Query parameters

pageinteger

Page number, from 1.

curl "https://creatoros-production-5658.up.railway.app/v1/skool/followers" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "page": 1,
  "pageSize": 30,
  "total": 2683,
  "totalPages": 90,
  "hasMore": true,
  "followers": [
    {
      "id": "fdf7…",
      "username": "patrick-py-7015",
      "firstName": "Patrick",
      "bio": "Builder",
      "links": {
        "instagram": null,
        "website": "https://…"
      },
      "youFollow": false
    }
  ]
}

Following

GET/v1/skool/following

People the connected profile follows, 30 per page. Same shape as followers, under following.

Query parameters

pageinteger

Page number, from 1.

curl "https://creatoros-production-5658.up.railway.app/v1/skool/following" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "page": 1,
  "pageSize": 30,
  "total": 21,
  "totalPages": 1,
  "hasMore": false,
  "following": [
    {
      "id": "a0c1…",
      "username": "sam-builds",
      "firstName": "Sam",
      "youFollow": true
    }
  ]
}

DM conversations

GET/v1/skool/chats

Your Skool direct messages, newest first. Read one with GET /v1/skool/chats/{chatId}/messages (newest 30; around a message id + before to page back), mark it read with POST …/read.

Query parameters

unreadOnlyboolean

Only unread conversations.

limitinteger

Up to 100.

offsetinteger

Skip this many.

curl "https://creatoros-production-5658.up.railway.app/v1/skool/chats" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "count": 1,
  "chats": [
    {
      "id": "3a25…",
      "with": {
        "id": "fbed…",
        "username": "bessan-ismail-8033",
        "firstName": "Bessan"
      },
      "unread": 0,
      "lastMessageAt": "2026-09-27T15:09:18Z"
    }
  ]
}

Read a conversation

GET/v1/skool/chats/{chatId}/messages

The newest 30 messages, oldest first, with images, files and video links. To page back, pass the oldest message id as around and before=30. before and after count messages, not dates.

Path parameters

chatIdstringrequired

The conversation id.

Query parameters

aroundstring

A message id to page from.

beforeinteger

How many messages before it.

afterinteger

How many messages after it.

curl "https://creatoros-production-5658.up.railway.app/v1/skool/chats/3a2570477aa24bc5bf0b0c63926c17fd/messages" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "chat": {
    "id": "3a25…",
    "with": {
      "username": "bessan-ismail-8033",
      "firstName": "Bessan"
    }
  },
  "hasMoreBefore": true,
  "hasMoreAfter": false,
  "messages": [
    {
      "id": "ee4f…",
      "content": "Hey! Loved the last post",
      "sentByYou": false,
      "attachments": [],
      "videoLinks": [],
      "createdAt": "2026-09-27T15:09:18Z"
    }
  ]
}

Mark a conversation read

POST/v1/skool/chats/{chatId}/read

Clears the unread badge. Pass lastMessageId to mark read up to that message, or leave it out for everything.

Path parameters

chatIdstringrequired

The conversation id.

Body

lastMessageIdstring

Read up to this message.

curl -X POST "https://creatoros-production-5658.up.railway.app/v1/skool/chats/3a2570477aa24bc5bf0b0c63926c17fd/read" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Response 200
{
  "ok": true
}

Send a DM

POST/v1/skool/chats/{chatId}/messages

Sends a message in an existing conversation. To start a new one, POST /v1/skool/chats with userId and a community you share (Skool sends them a chat request). Block someone from messaging you with POST /v1/skool/users/{userId}/block (DELETE to unblock); GET /v1/skool/blocked lists them.

Path parameters

chatIdstringrequired

The conversation id.

Body

contentstringrequired

Message text.

curl -X POST "https://creatoros-production-5658.up.railway.app/v1/skool/chats/3a2570477aa24bc5bf0b0c63926c17fd/messages" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Welcome in! Glad you joined 🙌"
  }'
Response 201
{
  "id": "ee4f…",
  "content": "Welcome in! Glad you joined 🙌",
  "sentByYou": true,
  "createdAt": "2026-09-28T21:30:00Z"
}

Start a conversation

POST/v1/skool/chats

Sends someone a chat request. Skool only allows this between members of a shared community, so name one you both belong to.

Body

userIdstringrequired

Their Skool user id (from members, followers or comments).

communitystringrequired

Slug of a shared community you both belong to.

curl -X POST "https://creatoros-production-5658.up.railway.app/v1/skool/chats" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "fbed2c1a9d7e4b0f",
    "community": "creatoros-university"
  }'
Response 201
{
  "ok": true,
  "chat": {
    "id": "9c1d…",
    "with": {
      "username": "maya-fit",
      "firstName": "Maya"
    }
  }
}

Blocked users

GET/v1/skool/blocked

People blocked from messaging you.

Query parameters

limitinteger

Up to 100.

offsetinteger

Skip this many.

curl "https://creatoros-production-5658.up.railway.app/v1/skool/blocked" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "count": 1,
  "users": [
    {
      "id": "d41e…",
      "username": "spam-account-1",
      "firstName": "Spam"
    }
  ]
}

Block or unblock

POST/v1/skool/users/{userId}/block

Stops someone messaging you. DELETE the same path to unblock.

Path parameters

userIdstringrequired

Their Skool user id.

curl -X POST "https://creatoros-production-5658.up.railway.app/v1/skool/users/d41e0b7c2a9f4e18/block" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "ok": true,
  "blocked": true
}

Post to several communities

POST/v1/skool/posts

One post to several shared read & write communities, with a result per community. labelIds maps a slug to its category where a community has several. Communities you're only a member of work too if you shared them as read & write; post there sparingly.

Body

communitiesstring[]required

Community slugs.

titlestringrequired

Post title.

contentstringrequired

Post body.

labelIdsobject

{ "<slug>": "<label id>" } where needed.

pollOptionsstring[]

Attach a poll.

mediastring[]

Public URLs of images, videos or any file such as a PDF (or med_ ids from POST /v1/media) to attach. Copied into the community.

videoLinksstring[]

YouTube, Vimeo, Loom or Wistia links, shown as embedded players.

notifyAllboolean

Email every member of each community.

curl -X POST "https://creatoros-production-5658.up.railway.app/v1/skool/posts" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "communities": [
      "creatoros-university",
      "kevs-no-code-academy"
    ],
    "title": "New drop",
    "content": "Details inside 👇"
  }'
Response 207
{
  "posted": 1,
  "results": [
    {
      "community": "creatoros-university",
      "ok": true,
      "post": {
        "id": "7c2d…"
      }
    },
    {
      "community": "kevs-no-code-academy",
      "ok": false,
      "error": "community_read_only"
    }
  ]
}

Post categories

GET/v1/skool/communities/{slug}/labels

The community's post categories. A community with several needs a labelId on new posts (you get 400 category_required with the choices otherwise); with one, it's picked for you.

Path parameters

slugstringrequired

The community slug.

curl "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/labels" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "labels": [
    {
      "id": "4b2f…",
      "name": "General"
    },
    {
      "id": "8e1a…",
      "name": "Wins"
    }
  ]
}

List posts

GET/v1/skool/communities/{slug}/posts

One page (about 30) of the community feed.

Path parameters

slugstringrequired

The community slug.

Query parameters

pageinteger

Page number, from 1.

sortstring

newest-cm (default), newest, best-1w, best-1m or best-1y.

labelIdstring

Only this category.

curl "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/posts" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "page": 1,
  "total": 142,
  "posts": [
    {
      "id": "1d676deee21f431ea2d9780903be3c0a",
      "slug": "welcome",
      "title": "Welcome in",
      "content": "Start here…",
      "likes": 6,
      "commentCount": 1,
      "isPinned": true,
      "createdAt": "2026-09-20T15:02:11Z",
      "url": "https://www.skool.com/creatoros-university/welcome"
    }
  ]
}

Find posts

GET/v1/skool/communities/{slug}/posts/filter

Walks the feed newest-first and filters, for example every post with no replies yet.

Path parameters

slugstringrequired

The community slug.

Query parameters

sinceISO 8601

Created on or after.

untilISO 8601

Created before.

unansweredboolean

true for posts with no comments.

textstring

Match in title or body.

minCommentsinteger

At least this many comments.

labelIdstring

Only this category.

curl "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/posts/filter" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "count": 3,
  "posts": [
    {
      "id": "5b1e…",
      "title": "How do I price my offer?",
      "commentCount": 0
    }
  ]
}

Get a post

GET/v1/skool/communities/{slug}/posts/{postId}

One post with its body, category, likes, comment count and pin state.

Path parameters

slugstringrequired

The community slug.

postIdstringrequired

The post id.

curl "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/posts/1d676deee21f431ea2d9780903be3c0a" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "id": "1d676deee21f431ea2d9780903be3c0a",
  "title": "Welcome in",
  "content": "Start here…",
  "likes": 6,
  "commentCount": 1,
  "isPinned": true,
  "url": "https://www.skool.com/creatoros-university/welcome"
}

Create a post

POST/v1/skool/communities/{slug}/posts

notifyAll also emails every member and can't be undone.

Path parameters

slugstringrequired

The community slug.

Body

titlestringrequired

Post title.

contentstringrequired

Post body.

labelIdstring

Category.

notifyAllboolean

Email every member.

pollOptionsstring[]

Attach a poll with these choices.

mediastring[]

Public URLs of images, videos or any file such as a PDF (or med_ ids from POST /v1/media) to attach. Copied into the community.

videoLinksstring[]

YouTube, Vimeo, Loom or Wistia links, shown as embedded players.

curl -X POST "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/posts" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Live Q&A Friday",
    "content": "Drop your questions below 👇"
  }'
Response 201
{
  "id": "7c2d…",
  "title": "Live Q&A Friday",
  "url": "https://www.skool.com/creatoros-university/live-qa-friday"
}

Edit a post

PATCH/v1/skool/communities/{slug}/posts/{postId}

Change the title, body or category. Fields you leave out stay as they are. Comments are posts in Skool, so this edits your comments too.

Path parameters

slugstringrequired

The community slug.

postIdstringrequired

The post id.

Body

titlestring

New title.

contentstring

New body.

labelIdstring

New category.

curl -X PATCH "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/posts/1d676deee21f431ea2d9780903be3c0a" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Updated: the Q&A moved to 3pm ET."
  }'
Response 200
{
  "id": "1d676deee21f431ea2d9780903be3c0a",
  "title": "Live Q&A Friday",
  "content": "Updated: the Q&A moved to 3pm ET."
}

Delete a post

DELETE/v1/skool/communities/{slug}/posts/{postId}

Deletes a post or comment for good.

Path parameters

slugstringrequired

The community slug.

postIdstringrequired

The post id.

curl -X DELETE "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/posts/1d676deee21f431ea2d9780903be3c0a" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "ok": true
}

Pin or unpin

POST/v1/skool/communities/{slug}/posts/{postId}/pin

Pins the post to the top of the feed. DELETE the same path to unpin.

Path parameters

slugstringrequired

The community slug.

postIdstringrequired

The post id.

curl -X POST "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/posts/1d676deee21f431ea2d9780903be3c0a/pin" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "ok": true
}

Like or unlike

POST/v1/skool/communities/{slug}/posts/{postId}/like

Likes a post or comment. DELETE the same path to take the like back.

Path parameters

slugstringrequired

The community slug.

postIdstringrequired

The post id.

curl -X POST "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/posts/1d676deee21f431ea2d9780903be3c0a/like" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "ok": true
}

List comments

GET/v1/skool/communities/{slug}/posts/{postId}/comments

The whole thread, with replies nested under their comment (?nested=false for a flat list).

Path parameters

slugstringrequired

The community slug.

postIdstringrequired

The post id.

curl "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/posts/1d676deee21f431ea2d9780903be3c0a/comments" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "count": 2,
  "comments": [
    {
      "id": "a1…",
      "content": "Glad to be here!",
      "isReply": false,
      "replies": [
        {
          "id": "b2…",
          "content": "Welcome!",
          "isReply": true,
          "replies": []
        }
      ]
    }
  ]
}

Comment or reply

POST/v1/skool/communities/{slug}/posts/{postId}/comments

Comments on the post, or replies to a comment when parentId is set.

Path parameters

slugstringrequired

The community slug.

postIdstringrequired

The post id.

Body

contentstringrequired

Comment text.

parentIdstring

Comment id to reply to.

curl -X POST "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/posts/1d676deee21f431ea2d9780903be3c0a/comments" \
  -H "Authorization: Bearer $CREATOROS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Great question, here is how I do it…"
  }'
Response 201
{
  "id": "c3…",
  "content": "Great question, here is how I do it…",
  "isReply": false
}

List members

GET/v1/skool/communities/{slug}/members

30 per page, with role, join date, last activity and join-application answers. tab picks who: active (default), churned (left), banned, pending, invited or admin. Active + churned + banned is everyone who ever joined. Tabs other than active need you to own or admin the community.

Path parameters

slugstringrequired

The community slug.

Query parameters

tabstring

active (default), churned, banned, pending, invited or admin.

pageinteger

Page number, from 1.

searchstring

Name to search for.

sortstring

-memberapprovedat, -memberlastoffline or -memberpoints.

curl "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/members" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "tab": "churned",
  "page": 1,
  "totalPages": 12,
  "total": 337,
  "members": [
    {
      "memberId": "m9…",
      "username": "maya-fit",
      "firstName": "Maya",
      "role": "member",
      "joinedAt": "2026-03-02T10:11:00Z"
    }
  ]
}

Member emails

GET/v1/skool/communities/{slug}/members/emails

Every email the community collected through its join application (Skool shows admins nothing else). Scans up to maxPages pages of a tab; complete says whether it reached the end. Owner or admin only.

Path parameters

slugstringrequired

The community slug.

Query parameters

tabstring

active (default), churned, banned, pending, invited or admin.

maxPagesinteger

1 to 200, default 20 (30 members per page).

curl "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/members/emails" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "tab": "active",
  "scanned": 600,
  "count": 588,
  "complete": false,
  "emails": [
    {
      "memberId": "m9…",
      "username": "maya-fit",
      "firstName": "Maya",
      "lastName": "Lee",
      "email": "maya@example.com"
    }
  ]
}

Pending join requests

GET/v1/skool/communities/{slug}/members/pending

People waiting to join, with their answers to your membership questions. Approve with POST …/members/{memberId}/approve or decline with …/deny.

Path parameters

slugstringrequired

The community slug.

curl "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/members/pending" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "count": 1,
  "members": [
    {
      "memberId": "m9…",
      "firstName": "Maya",
      "email": "maya@example.com",
      "application": [
        {
          "question": "What do you create?",
          "answer": "Fitness reels"
        }
      ]
    }
  ]
}

Approve or deny a request

POST/v1/skool/communities/{slug}/members/{memberId}/approve

Lets a pending member in. POST …/members/{memberId}/deny declines them instead. Owner or admin only.

Path parameters

slugstringrequired

The community slug.

memberIdstringrequired

The memberId from pending join requests.

curl -X POST "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/members/6f0a1c9e2b7d4e35/approve" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "ok": true,
  "memberId": "6f0a1c9e2b7d4e35",
  "role": "member"
}

Revenue

GET/v1/skool/communities/{slug}/revenue

Current members, MRR and retention (0 to 1). Skool reports MRR in cents; mrr_usd is the same in dollars.

Path parameters

slugstringrequired

The community slug.

curl "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/revenue" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "members": 2051,
  "mrr_cents": 10000,
  "mrr_usd": 100,
  "retention": 0.89
}

Growth (30 days)

GET/v1/skool/communities/{slug}/growth

About-page visitors, signups, conversion (signups ÷ visitors) and new MRR in dollars over the last 30 days.

Path parameters

slugstringrequired

The community slug.

curl "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/growth" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "period": "last_30_days",
  "visitors": 180,
  "signups": 4,
  "conversion": 0.0222,
  "new_mrr_usd": 35
}

Dashboard chart

GET/v1/skool/communities/{slug}/charts/{chart}

One of Skool's dashboard time series, money in dollars: mrr, mrr_unit (ARPU, LTV), mrr_cashflow, members, members_cohorts, retention_members, retention_cohorts, and visits, signups, conversion and new MRR _by_day or _by_source, plus conversion_trials.

Path parameters

slugstringrequired

The community slug.

chartstringrequired

The chart name.

curl "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/charts/mrr" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "chart": "mrr",
  "items": [
    {
      "date": "2026-08-01",
      "mrr": 95,
      "new": 0,
      "existing": 105,
      "churn": -10,
      "upgrade": 0,
      "downgrade": 0,
      "reactivation": 0
    }
  ]
}

Engagement

GET/v1/skool/communities/{slug}/engagement

Total members per day and currently active members.

Path parameters

slugstringrequired

The community slug.

Query parameters

rangestring

Period, e.g. 30d (default).

curl "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/engagement" \
  -H "Authorization: Bearer $CREATOROS_API_KEY"
Response 200
{
  "range": "30d",
  "total_members": [
    {
      "date": "2026-09-27",
      "members": 2050
    }
  ],
  "active_members": 312
}