Skool API

POST https://cotlet.dev/api/v1/skool/list_groups

Returns every Skool group your account belongs to, both groups you own and groups you joined. Use the group field from each item as the group parameter of the other endpoints. Member count is the number Skool shows on the group page.

Parameters

No parameters.

Request

curl -X POST https://cotlet.dev/api/v1/skool/list_groups \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("skool", "list_groups")

const result = await cotlet.call('skool', 'list_groups');

cotlet call skool list_groups

Example response

{
  "groups": [
    {
      "group": "yourgroup",
      "name": "Landing Page Lab",
      "role": "admin",
      "members": 1284,
      "price": "$49/month",
      "url": "https://www.skool.com/yourgroup"
    },
    {
      "group": "creator-club",
      "name": "Creator Club",
      "role": "member",
      "members": 9310,
      "price": "free",
      "url": "https://www.skool.com/creator-club"
    }
  ]
}

POST https://cotlet.dev/api/v1/skool/list_members

Lists members of one group, newest first. Filter by role or by join date to find this week's new members. Level is the Skool gamification level (1 to 9) and points are the likes that count toward it. Pages hold up to 100 members; pass next_cursor back as cursor for the next page.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/skool/list_members \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"yourgroup"}'

result = client.call("skool", "list_members", {"group":"yourgroup"})

const result = await cotlet.call('skool', 'list_members', {"group":"yourgroup"});

cotlet call skool list_members --data '{"group":"yourgroup"}'

Example response

{
  "members": [
    {
      "member_id": "m_8c41d2",
      "name": "Ana Lopez",
      "role": "member",
      "level": 2,
      "points": 14,
      "joined_at": "2026-10-01T18:21:00Z",
      "profile_url": "https://www.skool.com/@ana-lopez"
    }
  ],
  "next_cursor": "eyJvZmZzZXQiOjUwfQ"
}

POST https://cotlet.dev/api/v1/skool/list_membership_requests

Lists pending requests to join a private group, oldest first, with the answers each applicant gave to your Membership Questions. Only admins and moderators see requests; for other roles the call fails with a permission error. Pass request_id to approve_membership_request or decline_membership_request.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/skool/list_membership_requests \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"yourgroup"}'

result = client.call("skool", "list_membership_requests", {"group":"yourgroup"})

const result = await cotlet.call('skool', 'list_membership_requests', {"group":"yourgroup"});

cotlet call skool list_membership_requests --data '{"group":"yourgroup"}'

Example response

{
  "requests": [
    {
      "request_id": "r_51e0aa",
      "name": "Tom Becker",
      "requested_at": "2026-10-03T07:45:00Z",
      "answers": [
        {
          "question": "What are you building?",
          "answer": "A SaaS for dental clinics, launching in November."
        }
      ]
    }
  ],
  "next_cursor": null
}

POST https://cotlet.dev/api/v1/skool/list_posts

Lists posts in the community feed, newest first, the same order as the feed with the Newest sort. Filter by category or by creation time to see what came in since your last check. Body is a short preview; get_post returns the full text and comments.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/skool/list_posts \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"yourgroup"}'

result = client.call("skool", "list_posts", {"group":"yourgroup"})

const result = await cotlet.call('skool', 'list_posts', {"group":"yourgroup"});

cotlet call skool list_posts --data '{"group":"yourgroup"}'

Example response

{
  "posts": [
    {
      "post_id": "a3f9c2e1b7d84c06",
      "title": "Week 12 challenge: ship one landing page",
      "author": "You",
      "category": "Announcements",
      "likes": 23,
      "comments": 7,
      "pinned": true,
      "created_at": "2026-10-03T07:00:00Z",
      "preview": "Post your link below by Sunday..."
    }
  ],
  "next_cursor": "eyJvZmZzZXQiOjIwfQ"
}

POST https://cotlet.dev/api/v1/skool/get_post

Returns one post with its full body, attachments (images, files, links) and the whole comment tree, replies nested under their parent comment. Use it before replying so your agent sees the full discussion.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/skool/get_post \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"yourgroup","post_id":"post_8c41d2"}'

result = client.call("skool", "get_post", {"group":"yourgroup","post_id":"post_8c41d2"})

const result = await cotlet.call('skool', 'get_post', {"group":"yourgroup","post_id":"post_8c41d2"});

cotlet call skool get_post --data '{"group":"yourgroup","post_id":"post_8c41d2"}'

Example response

{
  "post_id": "a3f9c2e1b7d84c06",
  "title": "Week 12 challenge: ship one landing page",
  "body": "Post your link below by Sunday. Best three get a live review on Thursday's call.",
  "author": {
    "member_id": "m_0001",
    "name": "You"
  },
  "attachments": [],
  "comments": [
    {
      "comment_id": "c_77ab",
      "author": "Ana Lopez",
      "body": "Here's mine: ana.dev/launch",
      "likes": 3,
      "replies": [
        {
          "comment_id": "c_77b0",
          "author": "You",
          "body": "Love the headline!"
        }
      ]
    }
  ]
}

POST https://cotlet.dev/api/v1/skool/list_courses

Lists courses in the group's Classroom with their modules in order. Unlock rule says who can open each course: open to all members, unlocked at a level, or paid. Use the module URLs in welcome messages.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/skool/list_courses \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"yourgroup"}'

result = client.call("skool", "list_courses", {"group":"yourgroup"})

const result = await cotlet.call('skool', 'list_courses', {"group":"yourgroup"});

cotlet call skool list_courses --data '{"group":"yourgroup"}'

Example response

{
  "courses": [
    {
      "course_id": "co_12",
      "title": "Start Here",
      "unlock": "open",
      "modules": [
        {
          "title": "Welcome",
          "url": "https://www.skool.com/yourgroup/classroom/co_12?md=1"
        },
        {
          "title": "Your first week",
          "url": "https://www.skool.com/yourgroup/classroom/co_12?md=2"
        }
      ]
    },
    {
      "course_id": "co_19",
      "title": "Advanced Funnels",
      "unlock": "level 3",
      "modules": []
    }
  ]
}

POST https://cotlet.dev/api/v1/skool/list_conversations

Lists your Skool Chat conversations, most recent first, with the other person, unread count and a preview of the last message. Set unread_only to see only what needs an answer.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/skool/list_conversations \
  -H "Authorization: Bearer $COTLET_API_KEY"

result = client.call("skool", "list_conversations")

const result = await cotlet.call('skool', 'list_conversations');

cotlet call skool list_conversations

Example response

{
  "conversations": [
    {
      "conversation_id": "cv_93f1",
      "with": {
        "member_id": "m_8c41d2",
        "name": "Ana Lopez"
      },
      "unread": 2,
      "last_message": "Is the Thursday call recorded?",
      "updated_at": "2026-10-02T16:02:00Z"
    }
  ],
  "next_cursor": null
}

POST https://cotlet.dev/api/v1/skool/get_conversation

Returns the messages of one Skool Chat conversation, oldest first, so your agent reads the thread in order before answering.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/skool/get_conversation \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"conversation_id":"conversation_8c41d2"}'

result = client.call("skool", "get_conversation", {"conversation_id":"conversation_8c41d2"})

const result = await cotlet.call('skool', 'get_conversation', {"conversation_id":"conversation_8c41d2"});

cotlet call skool get_conversation --data '{"conversation_id":"conversation_8c41d2"}'

Example response

{
  "conversation_id": "cv_93f1",
  "with": {
    "member_id": "m_8c41d2",
    "name": "Ana Lopez"
  },
  "messages": [
    {
      "from": "Ana Lopez",
      "body": "Hi! Quick question.",
      "sent_at": "2026-10-02T16:01:00Z"
    },
    {
      "from": "Ana Lopez",
      "body": "Is the Thursday call recorded?",
      "sent_at": "2026-10-02T16:02:00Z"
    }
  ]
}

POST https://cotlet.dev/api/v1/skool/get_group_stats

Returns membership and revenue numbers for a period, the same figures as the group's admin dashboard: total members, new joins, churned members and monthly recurring revenue. Admins only.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/skool/get_group_stats \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"yourgroup"}'

result = client.call("skool", "get_group_stats", {"group":"yourgroup"})

const result = await cotlet.call('skool', 'get_group_stats', {"group":"yourgroup"});

cotlet call skool get_group_stats --data '{"group":"yourgroup"}'

Example response

{
  "group": "yourgroup",
  "period": "30d",
  "members_total": 1284,
  "members_new": 96,
  "members_churned": 31,
  "mrr": {
    "amount": 41230,
    "currency": "USD"
  }
}

POST https://cotlet.dev/api/v1/skool/approve_membership_request

Approves one pending request, so the applicant becomes a member. Your AutoDM, if you set one, goes out as usual. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/skool/approve_membership_request \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"yourgroup","request_id":"r_51e0aa"}'

result = client.call("skool", "approve_membership_request", {"group":"yourgroup","request_id":"r_51e0aa"})

const result = await cotlet.call('skool', 'approve_membership_request', {"group":"yourgroup","request_id":"r_51e0aa"});

cotlet call skool approve_membership_request --data '{"group":"yourgroup","request_id":"r_51e0aa"}'

Example response

{
  "request_id": "r_51e0aa",
  "status": "approved",
  "member_id": "m_9d02f7"
}

POST https://cotlet.dev/api/v1/skool/decline_membership_request

Declines one pending request. The applicant is not notified with a reason. By default you confirm each call; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/skool/decline_membership_request \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"yourgroup","request_id":"request_8c41d2"}'

result = client.call("skool", "decline_membership_request", {"group":"yourgroup","request_id":"request_8c41d2"})

const result = await cotlet.call('skool', 'decline_membership_request', {"group":"yourgroup","request_id":"request_8c41d2"});

cotlet call skool decline_membership_request --data '{"group":"yourgroup","request_id":"request_8c41d2"}'

Example response

{
  "request_id": "r_51e0aa",
  "status": "declined"
}

POST https://cotlet.dev/api/v1/skool/create_post

Publishes a post to the feed in a given category, under your name. Links and images go in the body as URLs. Admin-only categories need an admin account. By default you confirm each post; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/skool/create_post \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"yourgroup","title":"Week 12 challenge: ship one landing page","body":"Post your link below by Sunday. Best three get a live review on Thursday'\''s call.","category":"Announcements"}'

result = client.call("skool", "create_post", {"group":"yourgroup","title":"Week 12 challenge: ship one landing page","body":"Post your link below by Sunday. Best three get a live review on Thursday's call.","category":"Announcements"})

const result = await cotlet.call('skool', 'create_post', {"group":"yourgroup","title":"Week 12 challenge: ship one landing page","body":"Post your link below by Sunday. Best three get a live review on Thursday's call.","category":"Announcements"});

cotlet call skool create_post --data '{"group":"yourgroup","title":"Week 12 challenge: ship one landing page","body":"Post your link below by Sunday. Best three get a live review on Thursday'\''s call.","category":"Announcements"}'

Example response

{
  "post_id": "a3f9c2e1b7d84c06",
  "status": "published",
  "category": "Announcements",
  "url": "https://www.skool.com/yourgroup/week-12-challenge-ship-one-landing-page",
  "created_at": "2026-10-03T09:00:00+02:00"
}

POST https://cotlet.dev/api/v1/skool/comment_on_post

Adds a comment to a post, or a reply under an existing comment when parent_comment_id is set. The comment appears under your name. By default you confirm each comment; you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/skool/comment_on_post \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"yourgroup","post_id":"a3f9c2e1b7d84c06","body":"Good question, Lena. Module 2 of Pricing covers exactly this: start with a fixed project fee, not hourly. What is the project scope?"}'

result = client.call("skool", "comment_on_post", {"group":"yourgroup","post_id":"a3f9c2e1b7d84c06","body":"Good question, Lena. Module 2 of Pricing covers exactly this: start with a fixed project fee, not hourly. What is the project scope?"})

const result = await cotlet.call('skool', 'comment_on_post', {"group":"yourgroup","post_id":"a3f9c2e1b7d84c06","body":"Good question, Lena. Module 2 of Pricing covers exactly this: start with a fixed project fee, not hourly. What is the project scope?"});

cotlet call skool comment_on_post --data '{"group":"yourgroup","post_id":"a3f9c2e1b7d84c06","body":"Good question, Lena. Module 2 of Pricing covers exactly this: start with a fixed project fee, not hourly. What is the project scope?"}'

Example response

{
  "comment_id": "c_77c4",
  "post_id": "a3f9c2e1b7d84c06",
  "parent_comment_id": null,
  "status": "published"
}

POST https://cotlet.dev/api/v1/skool/send_message

Sends a direct message in Skool Chat to one member and starts a conversation if there is none yet. Messages go out under your name; by default you confirm each one, and you can switch that off for this tool.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/skool/send_message \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"member_id":"m_8c41d2","body":"Welcome, Ana! You mentioned your first client launch. Start with the Welcome lesson here: https://www.skool.com/yourgroup/classroom/co_12?md=1"}'

result = client.call("skool", "send_message", {"member_id":"m_8c41d2","body":"Welcome, Ana! You mentioned your first client launch. Start with the Welcome lesson here: https://www.skool.com/yourgroup/classroom/co_12?md=1"})

const result = await cotlet.call('skool', 'send_message', {"member_id":"m_8c41d2","body":"Welcome, Ana! You mentioned your first client launch. Start with the Welcome lesson here: https://www.skool.com/yourgroup/classroom/co_12?md=1"});

cotlet call skool send_message --data '{"member_id":"m_8c41d2","body":"Welcome, Ana! You mentioned your first client launch. Start with the Welcome lesson here: https://www.skool.com/yourgroup/classroom/co_12?md=1"}'

Example response

{
  "conversation_id": "cv_93f1",
  "message_id": "msg_4410",
  "status": "sent",
  "sent_at": "2026-10-03T09:05:00+02:00"
}

POST https://cotlet.dev/api/v1/skool/pin_post

Pins a post to the top of the feed, where Skool allows up to 3 pinned posts, or to a Classroom page, which allows up to 12. Set pinned to false to unpin. Admins only. pin_post runs without asking first: pinning sends nothing to anyone and is undone with one call.

Parameters

Request

curl -X POST https://cotlet.dev/api/v1/skool/pin_post \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group":"yourgroup","post_id":"post_8c41d2"}'

result = client.call("skool", "pin_post", {"group":"yourgroup","post_id":"post_8c41d2"})

const result = await cotlet.call('skool', 'pin_post', {"group":"yourgroup","post_id":"post_8c41d2"});

cotlet call skool pin_post --data '{"group":"yourgroup","post_id":"post_8c41d2"}'

Example response

{
  "post_id": "a3f9c2e1b7d84c06",
  "pinned": true,
  "location": "feed"
}