Overview

The Whop 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. All of it 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"
}

New here? The Quickstart gets you from creating a key to a live checkout link in about five minutes.

How the API works

Authentication

Create an API key here under Account API Keys. Keys are scoped 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

The API is versioned by date. Send an Api-Version-Date header (like 2026-07-01) to pin the request and response shapes you built against; later changes won’t break a pinned caller. When you omit the header, requests use the original 2025-01-01 shapes, and generated SDKs always send the latest version they were built against. See Versioning.

Pagination

List endpoints return a data array plus a page_info object. Pass first to set the page size and 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"
	}
}

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.
Webhooks	Event notifications pushed to your server as things happen.
Stats	Aggregated financial, audience, and traffic reporting.

Money

Balances and every way funds move in or out.

Resource	What it’s for
Ledgers	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.
Verifications	Legal identity required before payouts and card issuing.

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.
Checkout Configurations	Turn a plan into a shareable, prefilled checkout link.

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, aggregated from pixel events.
Events	Conversion and engagement events tracked for attribution.

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
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.

Introduction

Reference

Core Resources

Money

Commerce

Partners

Workforce

Tracking

Ads

Media

Identity

Developer

Make a request

How the API works

Authentication

Versioning

Errors

Resources

Core Resources

Money

Commerce

Partners

Workforce

Tracking

Ads

Media

Identity

Developer

​Make a request

​How the API works

​Authentication

​Versioning

​Pagination

​Errors

​Resources

​Core Resources

​Money

​Commerce

​Partners

​Workforce

​Tracking

​Ads

​Media

​Identity

​Developer

Make a request

How the API works

Authentication

Versioning

Pagination

Errors

Resources

Core Resources

Money

Commerce

Partners

Workforce

Tracking

Ads

Media

Identity

Developer