--- title: "Create company" method: POST path: "/companies" tags: ["Companies"] --- # Create company `POST /companies` Create a new company. Pass parent_company_id to create a connected account under a platform, or omit it to create a company for the current user. Required permissions: - `company:create` - `company:basic:read` ## Request body - object — Parameters for CreateCompany - `country` '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' — The available countries on the platform - `description` string, nullable — A promotional pitch displayed to potential customers on the company's store page. - `email` string, nullable — The email address of the user who will own the connected account. Required when parent_company_id is provided. - `logo` object, nullable — The company's logo image. Accepts PNG, JPEG, or GIF format. - `id` string, required — The ID of an existing file object. - `metadata` object, nullable — A key-value JSON object of custom metadata to store on the company. - `parent_company_id` string, nullable — 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, nullable — Whether Whop sends transactional emails to customers on behalf of this company. Only applies when creating a connected account. - `title` string, required — The display name of the company shown to customers. ## Response `200` A successful response - Company — A company is a seller on Whop. Companies own products, manage members, and receive payouts. - `affiliate_instructions` string, nullable, required — Guidelines and instructions provided to affiliates explaining how to promote this company's products. - `created_at` string, date-time, required — The datetime the company was created. - `description` string, nullable, required — A promotional pitch written by the company creator, displayed to potential customers on the store page. - `featured_affiliate_product` object, nullable, required — 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 product. - `name` string, required — The display name of the product shown to customers. Maximum 50 characters. - `id` string, required — The unique identifier for the company. - `logo` object, nullable, required — The company's logo. - `url` string, nullable, required — A pre-optimized URL for rendering this attachment on the client. This should be used for displaying attachments in apps. - `member_count` integer, required — The total number of users who currently hold active memberships across all of this company's products. - `metadata` object, nullable, 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. - `id` string, required — The unique identifier for the user. - `name` string, nullable, required — The user's display name shown on their public profile. - `username` string, required — The user's unique username shown on their public profile. - `published_reviews_count` integer, required — The total number of published customer reviews across all products for this company. - `route` string, required — URL slug for the account's store page, e.g. `pickaxe` in whop.com/pickaxe. - `send_customer_emails` boolean, required — Whether Whop sends transactional emails (receipts, updates) to customers on behalf of this company. - `social_links` object[], required — The list of social media accounts and external links associated with this company. - `id` string, required — The unique identifier for the social link. - `url` string, required — The URL of the social media profile or external link. - `website` 'x' | 'instagram' | 'facebook' | 'tiktok' | 'youtube' | 'linkedin' | 'twitch' | 'website' | 'custom', required — The different websites you can have social links for - `target_audience` string, nullable, required — The target audience for the company. Null if not set. - `title` string, required — The display name of the company shown to customers. - `updated_at` string, date-time, required — The datetime the company was last updated. - `verified` boolean, required — Whether this company has been verified by Whop's trust and safety team. ## Other responses - `400` — Bad request - `401` — Unauthorized - `403` — Forbidden - `404` — Not found - `422` — Verification required - `429` — Too many requests - `500` — Internal server error --- [API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/versions/db0883548bc5/schema)