Forums

Create forum posts, fetch threads, and add comments or reactions inside any Whop community.

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

Initialize the SDK

TypeScript

import Whop from "@whop/sdk";

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

Create a post

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

TypeScript

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
});

Read posts

List operations paginate automatically.

TypeScript

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");

Comment on a post

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

TypeScript

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);
}

Like a post

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

TypeScript

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

Advanced features

Pinned posts

Pinned posts appear at the top of the feed. Use pinned: true when creating a post.

TypeScript

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

Mention users

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

TypeScript

await client.forumPosts.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.

TypeScript

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

Pagination with cursors

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

TypeScript

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,
});

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 chatbot

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.