Whop Developers

API Reference

SDK Reference

Start Building

Retrieve memberships possessed by the currently authenticated user as it relates to the company selling access to the specific software.

Retrieve User Memberships

The Discord account's user ID (~18 digits)

The Discord account's username, including the discriminator (Ex. John#1234)

Access Pass has been deprecated for Product. Please use product instead and do not use access_pass.

Gives the url of the page with the user's affiliate code appended. Does not guarantee the user can affiliate anything on the page.

Whether or not this membership is scheduled to cancel at the end of the renewal period.

The ID of the checkout session (like `ch_***************`) used to purchase this membership, if any.

The time at which the Membership was created. Measured in seconds since the Unix epoch.

Questions and answers collected from the User at checkout

The email of the User attached to this Membership

The time of when the Membership is set to go expired

The ID of the Membership, which will look like `mem_*************`

The URL to manage the Membership (top-up, cancel, etc.) 

The payment processor used to pay for the Membership.

The phone number of the User attached to this Membership, if its allowed to be shared.

The Plan attached to this Membership. By default this will just be the ID of the Plan, but you can expand it to get more information about the Plan by passing `[plan]` in the `expand` parameter.

The Product attached to this Membership. By default this will just be the ID of the Product, but you can expand it to get more information about the Product by passing `[product]` in the `expand` parameter.

The Promo Code used to purchase this Membership. By default this will just be the ID of the Promo Code, but you can expand it to get more information about the Promo Code by passing `[promo_code]` in the `expand` parameter.

The amount of items included in the Membership

The UTC timestamp of when the Membership will end

The UTC timestamp of when the Membership will begin

The Stripe Customer ID attached to this Membership if it was checked out using Stripe

The Stripe Subscription ID attached to this Membership if it was checked out using Stripe

The Whop ID of their connected Telegram account, if any.

The User that owns this Membership. By default this will just be the ID of the User, but you can expand it to get more information about the User by passing `[user]` in the `expand` parameter.

Whether or not the Membership has a valid status

The crypto wallet address used to pay for the Membership (if paid through the one-time ETH or renewal WETH Whop contracts)

The current page of the paginated response

The total number of objects in the paginated response (automatically maxed out at 50)

The total number of pages in the paginated response

Introduction

Before you start planning and developing your app, it’s important to understand what Whop apps do and how they fit into Whop.

Apps Overview

You're ready to create a new app. You want to set up your development environment so that you can start coding.

Create an app

After you create an app, you will build out the page that allows Whop Companies to interact with your app

Build your seller page

If your app is built for businesses to sell to users, then it's time to build your user page

Build your user page

Now that your app is built out, it's time to deploy

Deploying your app

Downloadable Software

Web Apps

Information about all the different app views, and variables available to them.

App views

Send a notification to your users using the Notifications API.

Send a notification

Learn how to add in-app purchases to your app.

In-App Purchases

Metered billing allows an app developer to charge a seller. This is one of the ways developers can make money selling apps

Metered Billing

Video App

Email app

A guide to using webhooks for real-time notifications and integrations

Overview

This page contains examples of how to use Whop to sell access to your software.

Templates

Contribute

Branding

An overview of authentication methods for the Whop API

Authentication

Rate Limits

List Companies

Retrieve a Company

List Experiences

Retrieve an Experience

Update an Experience

List Members

Retrieve a Member

Returns a collection of memberships. By default, the valid filter is set to true.

List Memberships

Retrieve a Membership

Add Free Days to Membership

List Products

Retrieve a Product

List Payments

Retrieve a Payment

List Reviews

Retrieve a Review

Create a Notification Request

Create a notification topic for a company

Create a Notification Topic

Returns a collection of notification topics

List Notification Topics

Retrieve a Notification Topic

List Line Items

Retrieve a Line Item

Create a Line Item

Delete a Line Item

Update a Line Item

List App Connections

Retrieve an app connection

Create an App Connection

Delete an App Connection

Retrieve a User

List a User's social accounts

List Billing Usages

Retrieve a Billing Usage

Create a Billing Usage

Delete a Billing Usage

Create a Feed Content Item

Create a Inbound Webhook

List Inbound Webhooks

Creates or updates a Inbound Webhook Filter for a given experience

Returns a collection of inbound webhook filters

List Inbound Webhooks Filters

Retrieve an Inbound Webhook Filter

Retrieve an Experience's Inbound Webhook Filters

Retrieve the current app

This endpoint checks the given access expression.

Check Access

Update a Membership

Terminates the membership. No further payments will be made, and the customer will lose access. A terminated membership cannot be reactivated.

Terminate a Membership

Create a Billing Item

List Billing Items

Retrieve a Billing Item

Update a Billing Item

Retrieve the current company

Create an OAuth Token

Retrieve the current user

Getting started developing an App on Whop

Installation

Whop Proxy

hasAccess

validateToken

getToken

Use the SDK to use our API and return it in a formatted JSON response

Whop API

Receiving Webhooks

Getting Started

Open external links from within the iFrame

Open External Links

Redirect URLs

Returns a collection of Memberships, based on the supplied filters. If a Membership is valid, the User has/should have access to the Experiences associated with the Product. If a Membership is invalid, the User will/should have their Product's Experiences unfulfilled. By default, results are returned 10 objects at a time.

Validate an instance of your software by sending metadata about the user. For example, by sending metadata containing the HWID of the device most recently logged in, you can ensure an instance of your software is only being used on one device at a time.

Validate a License Key

Returns a specific Membership, using its unique ID. A Membership represents an instance of a User purchasing a Product.

Terminates a specific Membership, using its unique ID. It will immediately invalidate the Membership, and the User will/should have their Product's Experiences unfulfilled. Termination is irreversible, so a User will have to re-purchase if they wish to continue their access.

Use the update license endpoint to add metadata like hwid to an instance of the License.

Cancels a specific Membership, using its unique ID. It will set the Membership to cancel at period end.

Cancel a Membership

Extend a Membership's next renewal date or expiration date by a specified number of days. Once the Membership's updated renewal/expiration date has been reached, it will renew or expire as normal.

Add Free Days to a Membership

Returns a collection of Products, based on the supplied filters.

Returns a specific Product, using its unique ID.

Update a Product's attributes, using its unique ID. Keep in mind, any changes made to the pass will be reflected on the User's account.

Update a Product

Returns a collection of Plans, based on the supplied filters. Plans represent a pricing and release method configuration used to purchase a Product.

List Plans

Returns a specific Plan, using its unique ID. Plans represent a pricing and release method configuration used to purchase a Product.

Retrieve a Plan

Update a Plan

Create a plan

Create a quick link (or release link) for a plan. This will copy over all data from an existing plan and make a new plan with the same data that can be used as a one-time release link. You can change the stock and metadata on the new plan.

Create a quick link

Returns a collection of Experiences, based on the supplied filters. Experiences represent what the customer receives or unlocks when they purchase an Product. By default, results are returned 10 objects at a time

Returns a specific Experience, using its unique ID. Experiences represent what the customer receives or unlocks when they purchase a Membership.

Delete an Experience

Creates a new Checkout Session. A Checkout Session allows specific data to be attached to a Membership upon purchase and customization of the checkout experience.

Create a Checkout Session

Returns a collection of Checkout Sessions, based on the supplied filters. By default, results are returned 10 objects at a time.

Retrieve a Checkout Session

List Checkout Sessions

Deletes a specific Checkout Session, using its unique ID.

Delete a Checkout Session

Returns the Company that is attached the the API key.

Returns a list of all your members. Members are users who have a currently active membership.

Retrieve Member

Returns a collection of Payments, based on the supplied filters. Only Payments with a status of paid have been successfully processed.

Returns a specific Payment, using its unique ID. Only Payments with a status of paid have been successfully processed.

List Promo Codes

Retrieve a promo code

Update a promo code

Creates a new promo code with the given parameters. A promo code can offer a discount or a free period for a specific set of plans or for all plans in your company.

Create a promo code

Delete a promo code. You can only delete a promo code that has not been used yet. We recommend using the update endpoint and setting its status to 'archived' over this.

API Documentation

Apps

Company

Me

Retrieve User Memberships

Headers

Query Parameters

Response