Skip to main content
POST
/
products
Create Product
curl --request POST \
  --url https://{defaultHost}/products \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "company_id": "<string>",
  "visibility": "<string>",
  "headline": "<string>",
  "description": "<string>",
  "metadata": {},
  "route": "<string>",
  "global_affiliate_percentage": 123,
  "global_affiliate_status": "<string>",
  "member_affiliate_percentage": 123,
  "member_affiliate_status": "<string>",
  "custom_cta": "<string>",
  "custom_cta_url": "<string>",
  "custom_statement_descriptor": "<string>",
  "product_tax_code_id": "<string>",
  "redirect_purchase_url": "<string>",
  "collect_shipping_address": true
}
'
{
  "id": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>",
  "title": "<string>",
  "visibility": "<string>",
  "headline": "<string>",
  "verified": true,
  "member_count": 123,
  "route": "<string>",
  "published_reviews_count": 123,
  "external_identifier": "<string>",
  "metadata": {},
  "description": "<string>",
  "custom_cta": "<string>",
  "custom_cta_url": "<string>",
  "custom_statement_descriptor": "<string>",
  "global_affiliate_percentage": 123,
  "global_affiliate_status": "<string>",
  "member_affiliate_percentage": 123,
  "member_affiliate_status": "<string>",
  "gallery_images": "<array>",
  "product_tax_code": {},
  "owner_user": {},
  "company": {}
}

Authorizations

​
Authorization
string
header
required

An account API key, account scoped JWT, app API key, or user OAuth token.

Headers

​
Api-Version-Date
string<date>

Pins the request to a dated API version. When omitted, the request uses the original (2025-01-01) request/response shapes, so existing unversioned callers are never broken. Generated SDKs always send the latest version they were built against. An unrecognized value is rejected with a 400. The schemas documented here always describe the latest version.

Example:

"2026-06-20"

Body

application/json
​
title
string
required

The display name of the product. Maximum 80 characters.

​
company_id
string

The unique identifier of the company to create this product for.

​
visibility
string

Whether the product is visible to customers.

​
headline
string | null

A short marketing headline for the product page.

​
description
string | null

A written description displayed on the product page.

​
metadata
object

Custom key-value pairs to store on the product.

​
route
string | null

The URL slug for the product's public link.

​
global_affiliate_percentage
number | null

The commission rate affiliates earn.

​
global_affiliate_status
string

The enrollment status in the global affiliate program.

​
member_affiliate_percentage
number | null

The commission rate members earn.

​
member_affiliate_status
string

The enrollment status in the member affiliate program.

​
custom_cta
string | null

The call-to-action button label.

​
custom_cta_url
string | null

A URL the call-to-action button links to.

​
custom_statement_descriptor
string | null

Custom bank statement descriptor. Must start with WHOP*.

​
product_tax_code_id
string | null

The unique identifier of the tax classification code.

​
redirect_purchase_url
string | null

A URL to redirect the customer to after purchase.

​
collect_shipping_address
boolean | null

Whether to collect a shipping address at checkout.

Response

product created

​
id
string
required

Product ID, prefixed prod_.

​
created_at
string
required

When the product was created, as an ISO 8601 timestamp.

​
updated_at
string
required

When the product was last updated, as an ISO 8601 timestamp.

​
title
string | null
required

Product display name shown to customers.

​
visibility
string | null
required

Whether the product is publicly visible, hidden, or archived.

​
headline
string | null
required

Short marketing headline displayed on product page.

​
verified
boolean
required

Whether the product has been verified by Whop.

​
member_count
number
required

Active memberships for this product; 0 if public member counts are disabled.

​
route
string | null
required

URL slug for the product's public link.

​
published_reviews_count
number
required

Published customer reviews for this product.

​
external_identifier
string | null
required

External identifier stored on the product for your own reference.

​
metadata
object
required

Custom key-value pairs stored on the product.

​
description
string | null
required

Written description displayed on product page.

​
custom_cta
string | null
required

Call-to-action button label shown on the product purchase page.

​
custom_cta_url
string | null
required

URL the call-to-action button links to instead of checkout.

​
custom_statement_descriptor
string | null
required

Custom text label on customer's bank statement.

​
global_affiliate_percentage
number | null
required

Commission rate affiliates earn through the global affiliate program.

​
global_affiliate_status
string | null
required

Enrollment status in the global affiliate program.

​
member_affiliate_percentage
number | null
required

Commission rate members earn through the member affiliate program.

​
member_affiliate_status
string | null
required

Enrollment status in the member affiliate program.

​
gallery_images
array
required

Gallery images for this product.

​
product_tax_code
object
required

Tax classification code for this product, or null if no tax code is set.

​
owner_user
object
required

User who owns the account selling this product.

​
company
object
required

Account that sells this product.