Overview

The Current API is how you move money programmatically. Accept payments with checkout links, hold balances, send payouts, issue cards, transfer funds between accounts, and manage the products and plans you sell. Do it all from your server with one API key.

Make a request

The base URL is https://api.whop.com/api/v1. Authenticate every request with a Bearer API key:

curl https://api.whop.com/api/v1/accounts/me \
  -H "Authorization: Bearer $WHOP_API_KEY"

{
	"id": "biz_XXXXXXXX",
	"title": "Acme Studio",
	"route": "acme-studio",
	"status": "approved"
}

If you’re new, the Quickstart takes you from creating a key to a live checkout link in about five minutes.

How requests work

Authentication

Create an API key here under Account API Keys. Keys belong to an account and carry the permissions you grant them. Keep keys on your server, never in browser code, mobile apps, or public repos.

Versioning

Whop versions the API by date. Send an Api-Version-Date header, such as 2026-07-01, to pin the shapes of your requests and responses. Later changes won’t break a pinned caller. When you omit the header, requests use the original 2025-01-01 shapes. Generated SDKs always send the latest version available when Whop built them. See Versioning.

Pagination

List endpoints return a data array plus a page_info object. Pass first to choose the page size. Pass after with the previous response’s page_info.end_cursor to fetch the next page. page_info.has_next_page tells you when to stop.

Errors

Failed requests return a conventional HTTP status (400, 401, 403, 404) and a body with a single error object: type is a machine-readable code and message explains what went wrong.

{
	"error": {
		"type": "invalid_parameters",
		"message": "initial_price must be greater than 0"
	}
}

Where everything lives

This reference covers the Current API. These resources are documented in the Legacy API reference:

Charging: Payments, Refunds, Invoices, Payment methods
Content and community: Courses, Forums, Messages
Growth: Affiliates, Leads, Reviews

Use the API selector at the top of the sidebar to switch between references.

Resources

Core Resources

The accounts and people everything else hangs off.

Resource	What it’s for
Accounts	A business on Whop: profile, wallet, capabilities, settings.
Users	A person on Whop: profile and connected identities.
Team Members	An account’s team members and the roles that scope their access.
Members	One buyer’s relationship with an account, across all their purchases.
Webhooks	Event notifications pushed to your server as things happen.
Stats	Aggregated financial, audience, and traffic reporting.
Verifications	Legal identity required before payouts and card issuing.
Exports	Asynchronous CSV dumps of an account’s dashboard data.

Notifications

What users get told about, and how they tune it.

Resource	What it’s for
Notifications	The user’s notification feed: unread badges, mark-read, app sends, and the topic catalog.

Payments

Accept payments from buyers and handle what comes after.

Resource	What it’s for
Payments	A charge against a buyer, and the step they still owe.
Confirmation Tokens	A short-lived reference to payment details collected from a buyer.
Setup Intents	Saving a buyer’s payment method without charging it.
Disputes	Chargebacks filed against an account, with evidence and outcomes.
Dispute Alerts	Issuer warnings that arrive before a chargeback does.
Resolution Center Cases	File or respond to a case against a payment, as the buyer or the merchant.

Money

Balances and banking: every way funds move in or out.

Resource	What it’s for
Financial Activity	The activity feed behind an account or user’s balance.
Payouts	Send money from a balance to a bank or wallet.
Cards	Issue cards that spend from a balance.
Transfers	Move funds between Whop accounts and users.
Deposits	Add funds to a balance.
Swaps	Convert a balance between currencies.

Commerce

Sell products and get paid.

Resource	What it’s for
Products	The things you sell. Each owns plans and a store page.
Plans	Pricing for a product: one-time, recurring, trials, stock.
Promo Codes	Discounts that creators configure for checkout.
Memberships	A customer’s purchase of a plan, from checkout through cancellation.
Checkout Configurations	Turn a plan into a shareable, prefilled checkout link.
Payment Method Domains	Domains verified to show wallet payment methods like Apple Pay at checkout.
Shipments	Track the delivery of an order by its carrier tracking number.

Partners

Refer users and businesses to Whop and track what you earn.

Resource	What it’s for
Partners	The users and businesses you referred to Whop, and what you earn from them.

Workforce

Post paid tasks and pay people for completed work.

Resource	What it’s for
Bounties	Paid tasks with reviewed submissions and escrowed rewards.
Bounty Submissions	Work submitted to a bounty, from attempt to payout.

Tracking

Who visits and what converts, captured by the pixel.

Resource	What it’s for
People	Visitors and customers of an account, with identity, purchase, and traffic profiles.
Events	Conversion and engagement events tracked for attribution.
Recommended Actions	Suggested next-step action chains for an account.

Run and measure ad campaigns from your integration.

Resource	What it’s for
Ads	The creative: copy, assets, and destination URL.
Ad Campaigns	Platform, objective, and budget for a set of ads.
Ad Groups	Audience, placements, and schedule within a campaign.
Audiences	Reusable targeting lists for ad groups.

Media

Generate media assets from your integration.

Resource	What it’s for
Files	Upload files and attach them wherever Whop accepts documents.
Media	AI-generated assets, billed from a balance, attachable wherever files are accepted.

Identity

Accounts connected from other platforms.

Resource	What it’s for
Social Accounts	Connected Facebook and Instagram accounts that run ads.

Developer

Build, host, and observe apps on the Whop platform.

Resource	What it’s for
Apps	Apps you build on Whop: metadata, hosted builds, runtime logs.
App Builds	Versioned build artifacts deployed to an app’s platforms.
API Keys	Programmatic credentials for an account or app.
API Logs	Requests made to Whop’s API with your account’s API keys.
Permissions	What your credential is allowed to do on a resource.

Introduction

Reference

Webhooks & Events

Core Resources

Notifications

Payments

Money

Commerce

Partners

Workforce

Tracking

Ads

Media

Identity

Developer

Make a request

How requests work

Authentication

Versioning

Errors

Where everything lives

Resources

Core Resources

Notifications

Payments

Money

Commerce

Partners

Workforce

Tracking

Ads

Media

Identity

Developer

​Make a request

​How requests work

​Authentication

​Versioning

​Pagination

​Errors

​Where everything lives

​Resources

​Core Resources

​Notifications

​Payments

​Money

​Commerce

​Partners

​Workforce

​Tracking

​Ads

​Media

​Identity

​Developer

Make a request

How requests work

Authentication

Versioning

Pagination

Errors

Where everything lives

Resources

Core Resources

Notifications

Payments

Money

Commerce

Partners

Workforce

Tracking

Ads

Media

Identity

Developer