Post to Whop

Reelspan posts to a forum in your Whop company through the Whop API, with a company API key. Videos and photos are uploaded to Whop and attached to the post.

What you can post

The post's text is whop_title, else title, the same as the caption on every network. A separate post title is optional: send it as whop_post_title.

Whop's API doesn't return a link to the post, so url is null; post_id is the post's id.

Connect a forum

You need a company API key and the forum. Setup takes about two minutes.

1. In your Whop dashboard, open Developer and create a Company API key with the forum:read, forum:post:create and file permissions.
2. Open the forum and copy its experience id (exp_…) from the address bar.
3. For the company's public forum instead, leave the forum empty and use the company id (biz_…).
4. In the Reelspan dashboard, open Accounts → Connect account, choose the profile and Whop, and enter the key with the forum or the company id.

Reelspan checks the key against the forum before saving it, encrypted.

With the API

curl -X POST https://api.reelspan.com/v1/accounts/whop \
  -H "Authorization: Bearer $REELSPAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"profile_username": "my-brand", "api_key": "...", "forum": "exp_XXXXXXXX"}'

import { Reelspan } from 'reelspan';

const reelspan = new Reelspan();
await reelspan.accounts.connect('my-brand', 'whop', {
  api_key: process.env.WHOP_API_KEY,
  forum: 'exp_XXXXXXXX',
});

import os
from reelspan import Reelspan

reelspan = Reelspan()
reelspan.accounts.connect("my-brand", "whop", api_key=os.environ["WHOP_API_KEY"], forum="exp_XXXXXXXX")

For the company's public forum, send company_id instead of forum:

{ "profile_username": "my-brand", "api_key": "...", "company_id": "biz_XXXXXXXX" }

{ "success": true, "platform": "whop", "account": "Announcements", "reconnected": false }

account is the forum's name, or "Public forum".

Connecting again replaces the Whop account on that profile. See Connect with credentials.

Example post

A pinned post with a title and a video:

curl -X POST https://api.reelspan.com/v1/posts/video \
  -H "Authorization: Bearer $REELSPAN_API_KEY" \
  -F "user=my-brand" \
  -F "platform[]=whop" \
  -F "title=This week's lesson: pricing your first offer. Watch it, then post your price below." \
  -F "whop_post_title=Lesson 4: pricing" \
  -F "whop_pinned=true" \
  -F "[email protected]"

import { Reelspan } from 'reelspan';
import { readFile } from 'node:fs/promises';

const reelspan = new Reelspan();
const post = await reelspan.posts.video({
  user: 'my-brand',
  platforms: ['whop'],
  title: "This week's lesson: pricing your first offer. Watch it, then post your price below.",
  video: { data: await readFile('lesson.mp4'), name: 'lesson.mp4', type: 'video/mp4' },
  extra: { whop_post_title: 'Lesson 4: pricing', whop_pinned: 'true' },
});

from reelspan import Reelspan

reelspan = Reelspan()
post = reelspan.posts.video(
    "my-brand", ["whop"], "lesson.mp4",
    "This week's lesson: pricing your first offer. Watch it, then post your price below.",
    extra={"whop_post_title": "Lesson 4: pricing", "whop_pinned": "true"},
)

Fields

On Upload-Post, whop_title is the post's title. On Reelspan it is the post's text, as {network}_title is on every network; the title is whop_post_title.

In the dashboard composer, the Whop tab has Title and Pin to the top of the forum. A first_comment isn't posted on Whop; the result says "first_comment": "unsupported" with a warning.

Limits and behaviour

• Files: up to 2 GB each, uploaded to Whop as public files. Reelspan waits up to about a minute for Whop to process each one, then fails with processing_timeout, which is retried.
• Attachments: up to 10 photos per post; any more are dropped.
• No link: the result has no url; find the post in the forum.

Common errors

Errors when connecting come back as a 400 with the code in error_code. Errors when posting are in that network's result. See Errors.