Forums - Whop Docs

Use the Forums API to publish posts, comment on existing threads, and react to posts inside a Whop community’s forum experience. Forum content is scoped by experience_id, so each forum tile in a community sidebar is a separate experience.

Initialize the SDK

import Whop from "@whop/sdk";

const client = new Whop({
  appID: "app_xxxxxxxxxxxxx",
  apiKey: process.env.WHOP_API_KEY,
});

import os
from whop_sdk import Whop

client = Whop(
    app_id="app_xxxxxxxxxxxxx",
    api_key=os.environ["WHOP_API_KEY"],
)

Create a post

Posts support Markdown. Optional fields let you pin the post, paywall it, or mark it as a mention.

const post = await client.forumPosts.create({
  experience_id: "exp_xxxxxxxxxxxxx",
  content: "This is the post body in **Markdown**.",
  title: "Optional title for paywalled posts",
  pinned: false,
  is_mention: false,
  paywall_amount: 0, // cents; 500 = $5.00
});

post = client.forum_posts.create(
    experience_id="exp_xxxxxxxxxxxxx",
    content="This is the post body in **Markdown**.",
    title="Optional title for paywalled posts",
    pinned=False,
    is_mention=False,
    paywall_amount=0,
)

Read posts

List operations auto-paginate.

for await (const page of client.forumPosts.list({
  experience_id: "exp_xxxxxxxxxxxxx",
  first: 10,
})) {
  console.log(page);
}

const post = await client.forumPosts.retrieve("post_xxxxxxxxxxxxx");

for page in client.forum_posts.list(
    experience_id="exp_xxxxxxxxxxxxx",
    first=10,
):
    print(page)

post = client.forum_posts.retrieve("post_xxxxxxxxxxxxx")

Comment on a post

Comments are posts with a parent_id. Fetch them by passing the parent’s ID to list.

const comment = await client.forumPosts.create({
  experience_id: "exp_xxxxxxxxxxxxx",
  content: "Great post!",
  parent_id: "post_xxxxxxxxxxxxx",
});

for await (const page of client.forumPosts.list({
  experience_id: "exp_xxxxxxxxxxxxx",
  parent_id: "post_xxxxxxxxxxxxx",
  first: 10,
})) {
  console.log(page);
}

comment = client.forum_posts.create(
    experience_id="exp_xxxxxxxxxxxxx",
    content="Great post!",
    parent_id="post_xxxxxxxxxxxxx",
)

for page in client.forum_posts.list(
    experience_id="exp_xxxxxxxxxxxxx",
    parent_id="post_xxxxxxxxxxxxx",
    first=10,
):
    print(page)

Like a post

Forum reactions are always :heart:. Chat messages accept any emoji, but forum reactions ignore other values.

await client.reactions.create({
  resource_id: "post_xxxxxxxxxxxxx",
  emoji: ":heart:",
});

client.reactions.create(
    resource_id="post_xxxxxxxxxxxxx",
    emoji=":heart:",
)

Advanced features

Pinned posts

Pinned posts appear above the feed. Set pinned: true on create.

await client.forumPosts.create({
  experience_id: "exp_xxxxxxxxxxxxx",
  content: "Important announcement!",
  pinned: true,
});

client.forum_posts.create(
    experience_id="exp_xxxxxxxxxxxxx",
    content="Important announcement!",
    pinned=True,
)

Mention users

Use <@username> inline. Mentioned users get notified.

await client.forumPosts.create({
  experience_id: "exp_xxxxxxxxxxxxx",
  content: "Hey <@username> check this out!",
});

client.forum_posts.create(
    experience_id="exp_xxxxxxxxxxxxx",
    content="Hey <@username> check this out!",
)

Paywalled posts

paywall_amount is in cents. Readers must pay to see the full content.

await client.forumPosts.create({
  experience_id: "exp_xxxxxxxxxxxxx",
  title: "Premium post",
  content: "Exclusive content here",
  paywall_amount: 500, // $5.00
});

client.forum_posts.create(
    experience_id="exp_xxxxxxxxxxxxx",
    title="Premium post",
    content="Exclusive content here",
    paywall_amount=500,
)

Pagination with cursors

Beyond auto-pagination, you can step through pages manually using the cursor returned on each response.

const first = await client.forumPosts.list({
  experience_id: "exp_xxxxxxxxxxxxx",
  first: 10,
});

const next = await client.forumPosts.list({
  experience_id: "exp_xxxxxxxxxxxxx",
  first: 10,
  before: first.cursor,
});

first = client.forum_posts.list(
    experience_id="exp_xxxxxxxxxxxxx",
    first=10,
)

next_page = client.forum_posts.list(
    experience_id="exp_xxxxxxxxxxxxx",
    first=10,
    before=first.cursor,
)

Required permissions

Add these to your app’s permission list from the Permissions guide before publishing.

Permission	Needed for
`forum:read`	Reading posts and comments
`forum:post:create`	Creating posts and comments
`chat:read`	Creating and reading reactions

Post object shape

{
  id: string;
  comment_count: number;
  content: string | null;
  is_edited: boolean;
  is_pinned: boolean;
  is_poster_admin: boolean;
  like_count: number | null;
  parent_id: string | null; // null = top-level, set = comment
  title: string | null;
  view_count: number | null;
  user: { id: string; name: string | null; username: string };
}

Full schema: see the Forum posts API reference.

Next steps

Build a chat bot

Pair forum posts with live chat messages in the same community.

Listen to events with webhooks

React to forum posts and comments in realtime on your server.

Send notifications

Push users back to your forum when there’s something new.

Upload files

Attach images and videos to posts.

​Initialize the SDK

​Create a post

​Read posts

​Comment on a post

​Like a post

​Advanced features

​Pinned posts

​Mention users

​Paywalled posts

​Pagination with cursors

​Required permissions

​Next steps

Build a chat bot

Listen to events with webhooks

Send notifications

Upload files

Initialize the SDK

Create a post

Read posts

Comment on a post

Like a post

Advanced features

Pinned posts

Mention users

Paywalled posts

Pagination with cursors

Required permissions

Next steps