Skip to main content
POST
JavaScript

Authorizations

Authorization
string
header
required

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

application/json

Parameters for CreateCompany

title
string
required

The display name of the company shown to customers.

country
enum<string> | null

The country the company is located in. Defaults to the parent company's country for connected accounts, or the owner's IP-derived country.

Available options:
us,
ca,
gb,
ab,
af,
al,
dz,
as,
ad,
ao,
ai,
aq,
ag,
ar,
am,
aw,
au,
at,
az,
bs,
bh,
bd,
bb,
by,
be,
bz,
bj,
bm,
bt,
bo,
ba,
bw,
br,
io,
vg,
bn,
bg,
bf,
bi,
kh,
cm,
cv,
ky,
cf,
td,
cl,
cn,
cx,
cc,
co,
km,
cg,
ck,
cr,
ci,
hr,
cu,
cw,
cy,
cz,
cd,
dk,
dj,
dm,
do,
ec,
eg,
sv,
gq,
ee,
et,
fk,
fo,
fj,
fi,
fr,
gf,
pf,
ga,
gm,
ge,
de,
gh,
gi,
gr,
gl,
gd,
gp,
gu,
gt,
gg,
gn,
gw,
gy,
ht,
hn,
hk,
hu,
is,
in,
id,
iq,
ie,
im,
il,
it,
jm,
sj,
jp,
je,
jo,
kz,
ke,
ki,
xk,
kw,
kg,
la,
lv,
lb,
ls,
lr,
ly,
li,
lt,
lu,
mo,
mk,
mg,
mw,
my,
mv,
ml,
mt,
mh,
mq,
mr,
mu,
yt,
mx,
fm,
md,
mc,
mn,
me,
ms,
ma,
mz,
mm,
na,
nr,
np,
nl,
an,
nc,
nz,
ni,
ne,
ng,
nu,
mp,
no,
om,
pk,
pw,
ps,
pa,
pg,
py,
pe,
ph,
pn,
pl,
pt,
pr,
qa,
re,
ro,
ru,
rw,
bl,
sh,
kn,
lc,
mf,
pm,
vc,
ws,
sm,
st,
sa,
sn,
rs,
sc,
sl,
sg,
sx,
sk,
si,
sb,
so,
za,
kr,
ss,
es,
lk,
sd,
sr,
sz,
se,
ch,
tw,
tj,
tz,
th,
tl,
tg,
tk,
to,
tt,
tn,
tr,
tm,
tc,
tv,
vi,
ug,
ua,
ae,
um,
uy,
uz,
vu,
va,
ve,
vn,
wf,
eh,
ye,
zm,
zw,
sy
description
string | null

A promotional pitch displayed to potential customers on the company's store page.

email
string | null

The email address of the user who will own the connected account. Required when parent_company_id is provided.

logo
FileInputWithId · object | null

The company's logo image. Accepts PNG, JPEG, or GIF format.

metadata
object | null

A key-value JSON object of custom metadata to store on the company.

parent_company_id
string | null

The unique identifier of the parent platform company. When provided, creates a connected account under that platform. Omit to create a company for the current user.

send_customer_emails
boolean | null

Whether Whop sends transactional emails to customers on behalf of this company. Only applies when creating a connected account.

Response

A successful response

A company is a seller on Whop. Companies own products, manage members, and receive payouts.

affiliate_instructions
string | null
required

Guidelines and instructions provided to affiliates explaining how to promote this company's products.

Example:

"Share your unique link on social media to earn 20% commission."

created_at
string<date-time>
required

The datetime the company was created.

Example:

"2023-12-01T05:00:00.401Z"

description
string | null
required

A promotional pitch written by the company creator, displayed to potential customers on the store page.

Example:

"Learn the fundamentals of data analytics with hands-on projects."

The product featured for affiliates to promote on this company's affiliate page. Null if none is configured.

id
string
required

The unique identifier for the company.

Example:

"biz_xxxxxxxxxxxxxx"

logo
object | null
required

The company's logo.

member_count
integer
required

The total number of users who currently hold active memberships across all of this company's products.

Example:

42

metadata
object | null
required

A key-value JSON object of custom metadata for this company, managed by the platform that created the account.

owner_user
object
required

The user who owns and has full administrative control over this company.

published_reviews_count
integer
required

The total number of published customer reviews across all products for this company.

Example:

42

route
string
required

URL slug for the account's store page, e.g. pickaxe in whop.com/pickaxe.

Example:

"pickaxe"

send_customer_emails
boolean
required

Whether Whop sends transactional emails (receipts, updates) to customers on behalf of this company.

The list of social media accounts and external links associated with this company.

target_audience
string | null
required

The target audience for the company. Null if not set.

title
string
required

The display name of the company shown to customers.

Example:

"Pickaxe"

updated_at
string<date-time>
required

The datetime the company was last updated.

Example:

"2023-12-01T05:00:00.401Z"

verified
boolean
required

Whether this company has been verified by Whop's trust and safety team.