Introduction
Payins
Payouts
Identity
CRM
Engagement
Courses
Developer
AI
Stats
import Whop from '@whop/sdk';
const client = new Whop({
apiKey: process.env['WHOP_API_KEY'], // This is the default and can be omitted
});
const forumPost = await client.forumPosts.create({ experience_id: 'exp_xxxxxxxxxxxxxx' });
console.log(forumPost.id);{
"id": "<string>",
"title": "Weekly Market Analysis - February 2025",
"content": "## My Strategy\n\nHere are the key steps...",
"created_at": "2023-12-01T05:00:00.401Z",
"updated_at": "2023-12-01T05:00:00.401Z",
"is_edited": true,
"is_poster_admin": true,
"is_pinned": true,
"parent_id": "<string>",
"user": {
"id": "user_xxxxxxxxxxxxx",
"username": "johndoe42",
"name": "John Doe"
},
"attachments": [
{
"id": "<string>",
"filename": "document.pdf",
"content_type": "image/jpeg",
"url": "https://media.whop.com/abc123/optimized.jpg"
}
],
"view_count": 42,
"like_count": 42,
"comment_count": 42
}Create forum post
Create a new forum post or comment within an experience. Supports text content, attachments, polls, paywalling, and pinning. Pass experience_id ‘public’ with a company_id to post to a company’s public forum.
Required permissions:
forum:post:create
import Whop from '@whop/sdk';
const client = new Whop({
apiKey: process.env['WHOP_API_KEY'], // This is the default and can be omitted
});
const forumPost = await client.forumPosts.create({ experience_id: 'exp_xxxxxxxxxxxxxx' });
console.log(forumPost.id);{
"id": "<string>",
"title": "Weekly Market Analysis - February 2025",
"content": "## My Strategy\n\nHere are the key steps...",
"created_at": "2023-12-01T05:00:00.401Z",
"updated_at": "2023-12-01T05:00:00.401Z",
"is_edited": true,
"is_poster_admin": true,
"is_pinned": true,
"parent_id": "<string>",
"user": {
"id": "user_xxxxxxxxxxxxx",
"username": "johndoe42",
"name": "John Doe"
},
"attachments": [
{
"id": "<string>",
"filename": "document.pdf",
"content_type": "image/jpeg",
"url": "https://media.whop.com/abc123/optimized.jpg"
}
],
"view_count": 42,
"like_count": 42,
"comment_count": 42
}Authorizations
A company API key, company scoped JWT, app API key, or user OAuth token. You must prepend your key/token with the word 'Bearer', which will look like Bearer ***************************
Body
Parameters for CreateForumPostV2
The unique identifier of the experience to create this post in. For example, 'exp_xxxxx'. Pass 'public' along with company_id to automatically use the company's public forum.
"exp_xxxxxxxxxxxxxx"
The unique identifier of the company whose public forum to post in. Required when experience_id is 'public'. For example, 'biz_xxxxx'.
"biz_xxxxxxxxxxxxxx"
The main body of the post in Markdown format. For example, 'Check out this update'. Hidden if the post is paywalled and the viewer has not purchased access.
The rich content of the post in Tiptap JSON format. When provided, takes priority over the markdown content field for rendering.
The title of the post, displayed prominently at the top. Required for paywalled posts as it remains visible to non-purchasers.
A list of file attachments to include with the post, such as images or videos.
Show child attributes
Show child attributes
A poll to attach to this post, allowing members to vote on options.
Show child attributes
Show child attributes
The unique identifier of the parent post to comment on. Omit this field to create a top-level post.
Whether this post should be pinned to the top of the forum.
The price to unlock this post in the specified paywall currency. For example, 5.00 for $5.00. When set, users must purchase access to view the post content.
6.9
The currency for the paywall price on this post. When set along with paywall_amount, users must purchase access to view the post content.
usd, sgd, inr, aud, brl, cad, dkk, eur, nok, gbp, sek, chf, hkd, huf, jpy, mxn, myr, pln, czk, nzd, aed, eth, ape, cop, ron, thb, bgn, idr, dop, php, try, krw, twd, vnd, pkr, clp, uyu, ars, zar, dzd, tnd, mad, kes, kwd, jod, all, xcd, amd, bsd, bhd, bob, bam, khr, crc, xof, egp, etb, gmd, ghs, gtq, gyd, ils, jmd, mop, mga, mur, mdl, mnt, nad, ngn, mkd, omr, pyg, pen, qar, rwf, sar, rsd, lkr, tzs, ttd, uzs, rub, btc, cny, usdt Whether to send this post as a mention notification to all users in the experience who have mentions enabled.
Controls who can see this forum post, such as members only or public.
members_only, globally_visible Response
A successful response
A post or comment in a forum feed, supporting rich text, attachments, polls, and reactions.
Represents a unique identifier that is Base64 obfuscated. It is often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "VXNlci0xMA==") or integer (such as 4) input value will be accepted as an ID.
The headline of the forum post. Null if the post has no title.
"Weekly Market Analysis - February 2025"
The body of the forum post in Markdown format. Null if the post is paywalled and the current user does not have access.
"## My Strategy\n\nHere are the key steps..."
The time this post was created, as a Unix timestamp.
"2023-12-01T05:00:00.401Z"
The time this post was last updated, as a Unix timestamp.
"2023-12-01T05:00:00.401Z"
Whether this post has been edited after its initial creation.
Whether the author of this post is an admin of the company that owns the forum.
Whether this post is pinned to the top of the forum feed.
The unique identifier of the parent post. Null if this is a top-level post.
The user who authored this forum post.
Show child attributes
Show child attributes
All file attachments on this post, such as images, documents, and videos.
Show child attributes
Show child attributes
The total number of times this post has been viewed by users.
42
The total number of like reactions this post has received.
42
The total number of direct comments on this post.
42
Was this page helpful?