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
/v1/skoolThe 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"{
"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
/v1/skool/profileThe 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"{
"username": "kevbuildsapps",
"name": "Kev Builds Apps",
"followers": 2683,
"following": 21,
"posts": 491,
"url": "https://www.skool.com/@kevbuildsapps"
}Followers
/v1/skool/followersPeople 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
pageintegerPage number, from 1.
curl "https://creatoros-production-5658.up.railway.app/v1/skool/followers" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"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
/v1/skool/followingPeople the connected profile follows, 30 per page. Same shape as followers, under following.
Query parameters
pageintegerPage number, from 1.
curl "https://creatoros-production-5658.up.railway.app/v1/skool/following" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"page": 1,
"pageSize": 30,
"total": 21,
"totalPages": 1,
"hasMore": false,
"following": [
{
"id": "a0c1…",
"username": "sam-builds",
"firstName": "Sam",
"youFollow": true
}
]
}DM conversations
/v1/skool/chatsYour 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
unreadOnlybooleanOnly unread conversations.
limitintegerUp to 100.
offsetintegerSkip this many.
curl "https://creatoros-production-5658.up.railway.app/v1/skool/chats" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"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
/v1/skool/chats/{chatId}/messagesThe 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
chatIdstringrequiredThe conversation id.
Query parameters
aroundstringA message id to page from.
beforeintegerHow many messages before it.
afterintegerHow many messages after it.
curl "https://creatoros-production-5658.up.railway.app/v1/skool/chats/3a2570477aa24bc5bf0b0c63926c17fd/messages" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"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
/v1/skool/chats/{chatId}/readClears the unread badge. Pass lastMessageId to mark read up to that message, or leave it out for everything.
Path parameters
chatIdstringrequiredThe conversation id.
Body
lastMessageIdstringRead 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 '{}'{
"ok": true
}Send a DM
/v1/skool/chats/{chatId}/messagesSends 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
chatIdstringrequiredThe conversation id.
Body
contentstringrequiredMessage 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 🙌"
}'{
"id": "ee4f…",
"content": "Welcome in! Glad you joined 🙌",
"sentByYou": true,
"createdAt": "2026-09-28T21:30:00Z"
}Start a conversation
/v1/skool/chatsSends someone a chat request. Skool only allows this between members of a shared community, so name one you both belong to.
Body
userIdstringrequiredTheir Skool user id (from members, followers or comments).
communitystringrequiredSlug 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"
}'{
"ok": true,
"chat": {
"id": "9c1d…",
"with": {
"username": "maya-fit",
"firstName": "Maya"
}
}
}Blocked users
/v1/skool/blockedPeople blocked from messaging you.
Query parameters
limitintegerUp to 100.
offsetintegerSkip this many.
curl "https://creatoros-production-5658.up.railway.app/v1/skool/blocked" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"count": 1,
"users": [
{
"id": "d41e…",
"username": "spam-account-1",
"firstName": "Spam"
}
]
}Block or unblock
/v1/skool/users/{userId}/blockStops someone messaging you. DELETE the same path to unblock.
Path parameters
userIdstringrequiredTheir Skool user id.
curl -X POST "https://creatoros-production-5658.up.railway.app/v1/skool/users/d41e0b7c2a9f4e18/block" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"ok": true,
"blocked": true
}Post to several communities
/v1/skool/postsOne 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[]requiredCommunity slugs.
titlestringrequiredPost title.
contentstringrequiredPost 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.
notifyAllbooleanEmail 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 👇"
}'{
"posted": 1,
"results": [
{
"community": "creatoros-university",
"ok": true,
"post": {
"id": "7c2d…"
}
},
{
"community": "kevs-no-code-academy",
"ok": false,
"error": "community_read_only"
}
]
}Post categories
/v1/skool/communities/{slug}/labelsThe 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
slugstringrequiredThe community slug.
curl "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/labels" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"labels": [
{
"id": "4b2f…",
"name": "General"
},
{
"id": "8e1a…",
"name": "Wins"
}
]
}List posts
/v1/skool/communities/{slug}/postsOne page (about 30) of the community feed.
Path parameters
slugstringrequiredThe community slug.
Query parameters
pageintegerPage number, from 1.
sortstringnewest-cm (default), newest, best-1w, best-1m or best-1y.
labelIdstringOnly this category.
curl "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/posts" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"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
/v1/skool/communities/{slug}/posts/filterWalks the feed newest-first and filters, for example every post with no replies yet.
Path parameters
slugstringrequiredThe community slug.
Query parameters
sinceISO 8601Created on or after.
untilISO 8601Created before.
unansweredbooleantrue for posts with no comments.
textstringMatch in title or body.
minCommentsintegerAt least this many comments.
labelIdstringOnly this category.
curl "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/posts/filter" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"count": 3,
"posts": [
{
"id": "5b1e…",
"title": "How do I price my offer?",
"commentCount": 0
}
]
}Get a post
/v1/skool/communities/{slug}/posts/{postId}One post with its body, category, likes, comment count and pin state.
Path parameters
slugstringrequiredThe community slug.
postIdstringrequiredThe post id.
curl "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/posts/1d676deee21f431ea2d9780903be3c0a" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"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
/v1/skool/communities/{slug}/postsnotifyAll also emails every member and can't be undone.
Path parameters
slugstringrequiredThe community slug.
Body
titlestringrequiredPost title.
contentstringrequiredPost body.
labelIdstringCategory.
notifyAllbooleanEmail 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 👇"
}'{
"id": "7c2d…",
"title": "Live Q&A Friday",
"url": "https://www.skool.com/creatoros-university/live-qa-friday"
}Edit a post
/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
slugstringrequiredThe community slug.
postIdstringrequiredThe post id.
Body
titlestringNew title.
contentstringNew body.
labelIdstringNew 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."
}'{
"id": "1d676deee21f431ea2d9780903be3c0a",
"title": "Live Q&A Friday",
"content": "Updated: the Q&A moved to 3pm ET."
}Delete a post
/v1/skool/communities/{slug}/posts/{postId}Deletes a post or comment for good.
Path parameters
slugstringrequiredThe community slug.
postIdstringrequiredThe 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"{
"ok": true
}Pin or unpin
/v1/skool/communities/{slug}/posts/{postId}/pinPins the post to the top of the feed. DELETE the same path to unpin.
Path parameters
slugstringrequiredThe community slug.
postIdstringrequiredThe 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"{
"ok": true
}Like or unlike
/v1/skool/communities/{slug}/posts/{postId}/likeLikes a post or comment. DELETE the same path to take the like back.
Path parameters
slugstringrequiredThe community slug.
postIdstringrequiredThe 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"{
"ok": true
}List comments
/v1/skool/communities/{slug}/posts/{postId}/commentsThe whole thread, with replies nested under their comment (?nested=false for a flat list).
Path parameters
slugstringrequiredThe community slug.
postIdstringrequiredThe post id.
curl "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/posts/1d676deee21f431ea2d9780903be3c0a/comments" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"count": 2,
"comments": [
{
"id": "a1…",
"content": "Glad to be here!",
"isReply": false,
"replies": [
{
"id": "b2…",
"content": "Welcome!",
"isReply": true,
"replies": []
}
]
}
]
}Comment or reply
/v1/skool/communities/{slug}/posts/{postId}/commentsComments on the post, or replies to a comment when parentId is set.
Path parameters
slugstringrequiredThe community slug.
postIdstringrequiredThe post id.
Body
contentstringrequiredComment text.
parentIdstringComment 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…"
}'{
"id": "c3…",
"content": "Great question, here is how I do it…",
"isReply": false
}List members
/v1/skool/communities/{slug}/members30 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
slugstringrequiredThe community slug.
Query parameters
tabstringactive (default), churned, banned, pending, invited or admin.
pageintegerPage number, from 1.
searchstringName 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"{
"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
/v1/skool/communities/{slug}/members/emailsEvery 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
slugstringrequiredThe community slug.
Query parameters
tabstringactive (default), churned, banned, pending, invited or admin.
maxPagesinteger1 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"{
"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
/v1/skool/communities/{slug}/members/pendingPeople waiting to join, with their answers to your membership questions. Approve with POST …/members/{memberId}/approve or decline with …/deny.
Path parameters
slugstringrequiredThe community slug.
curl "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/members/pending" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"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
/v1/skool/communities/{slug}/members/{memberId}/approveLets a pending member in. POST …/members/{memberId}/deny declines them instead. Owner or admin only.
Path parameters
slugstringrequiredThe community slug.
memberIdstringrequiredThe 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"{
"ok": true,
"memberId": "6f0a1c9e2b7d4e35",
"role": "member"
}Revenue
/v1/skool/communities/{slug}/revenueCurrent members, MRR and retention (0 to 1). Skool reports MRR in cents; mrr_usd is the same in dollars.
Path parameters
slugstringrequiredThe community slug.
curl "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/revenue" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"members": 2051,
"mrr_cents": 10000,
"mrr_usd": 100,
"retention": 0.89
}Growth (30 days)
/v1/skool/communities/{slug}/growthAbout-page visitors, signups, conversion (signups ÷ visitors) and new MRR in dollars over the last 30 days.
Path parameters
slugstringrequiredThe community slug.
curl "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/growth" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"period": "last_30_days",
"visitors": 180,
"signups": 4,
"conversion": 0.0222,
"new_mrr_usd": 35
}Dashboard chart
/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
slugstringrequiredThe community slug.
chartstringrequiredThe chart name.
curl "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/charts/mrr" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"chart": "mrr",
"items": [
{
"date": "2026-08-01",
"mrr": 95,
"new": 0,
"existing": 105,
"churn": -10,
"upgrade": 0,
"downgrade": 0,
"reactivation": 0
}
]
}Engagement
/v1/skool/communities/{slug}/engagementTotal members per day and currently active members.
Path parameters
slugstringrequiredThe community slug.
Query parameters
rangestringPeriod, e.g. 30d (default).
curl "https://creatoros-production-5658.up.railway.app/v1/skool/communities/creatoros-university/engagement" \
-H "Authorization: Bearer $CREATOROS_API_KEY"{
"range": "30d",
"total_members": [
{
"date": "2026-09-27",
"members": 2050
}
],
"active_members": 312
}