> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot

> Connect Whop to HubSpot. Sync products, generate checkout links from deals and contacts, and see payments natively in Commerce Hub.

Download the [Whop app for HubSpot](https://ecosystem.hubspot.com/marketplace/listing/whoppayments-by-whop) to get started.

## Overview

The Whop × HubSpot integration brings your payment, subscription, and membership data into HubSpot using **native** Payment and Subscription objects — not custom properties or spreadsheets. Your sales team gets full visibility into revenue inside the CRM.

This guide covers what the integration does, how payments flow through the system, and how to connect Whop to HubSpot.

## What this integration does

| Feature                          | Description                                                                                                |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| **Product Sync**                 | Sync all Whop products and pricing plans into HubSpot's product library with one click.                    |
| **Checkout Link Generation**     | Generate and send Whop checkout sessions from a deal or contact record in HubSpot in 1–2 clicks.           |
| **Native Payment Records**       | Every Whop payment creates a native HubSpot payment record in Commerce Hub.                                |
| **Subscription Tracking**        | Recurring subscriptions appear as HubSpot subscription objects (status, MRR, ARR, billing method, etc.).   |
| **Deal & Contact Association**   | Payments and subscriptions are automatically linked to the relevant deal and/or contact.                   |
| **Multi-Payment Method Support** | Supports all payment methods enabled in your Whop account: card, ACH, financing, cryptocurrency, and more. |

## Connecting Whop to HubSpot

Setup is one-time and usually takes under 10 minutes.

### Prerequisites

* An active Whop account (free at [whop.com](https://whop.com))
* HubSpot account with admin or integration permissions
* At least one product in Whop (optional at setup; required to process payments)

### Part 1: Install the app in HubSpot

1. Open the [HubSpot App Marketplace](https://ecosystem.hubspot.com/marketplace) and search for the Whop integration.
2. Click the orange **Connect** button. If you have multiple HubSpot accounts, choose the correct one.
3. Confirm you have a Whop account (or create one at whop.com).
4. Click **Yes** to continue to the API key step.

### Part 2: Generate your Whop API key

1. Log into your [Whop dashboard](https://whop.com).
2. In the left sidebar, go to **Developer** → **API Keys**.
3. Click **Create API Key** and ensure all permission scopes are checked.
4. Name the key (e.g., "Whop Integration with HubSpot").
5. Copy the token as soon as it appears and store it securely. It will not be shown again.

<Tip>
  To update your API key later (e.g., after rotation), go to HubSpot
  **Settings** → **Integrations** → **Connected Apps** → **Whop** → **Settings**
  and paste the new key.
</Tip>

### Part 3: Connect the API key in HubSpot

1. In HubSpot, paste the API key into the field provided.
2. Click **Save**. You should see "API key saved."
3. Click **OK** to finish. The integration is now active.

## Syncing products

After connecting, sync your Whop products into HubSpot's product library so they’re available when generating checkout links.

### How to sync

1. In HubSpot go to **Settings** → **Integrations** → **Connected Apps** → **Whop**.
2. Click **Sync Products**.
3. All products in your Whop account are imported into the HubSpot product library.

### Product and pricing plan structure

Each Whop product can have multiple pricing plans. These map to the options your team sees when creating checkout sessions. For example:

* A "Three Month Coaching Program" product might have a $2,000 paid-in-full plan and a $500/month recurring plan.
* You can also use enrollment fees (e.g., $1,000 upfront then $500/month) or split-pay installments (e.g., \$500/month for 4 months).
* Plan configuration is done in Whop; once synced, all plans are available in HubSpot.

## Collecting payments from HubSpot

The integration adds a **Whop payment card** to deal and contact records. Your team can generate a checkout link in 1–2 clicks without leaving HubSpot.

### Adding the Whop card to deal and contact views

Do this once per view; the card stays for all records.

**For deal records:**

1. Open any deal in HubSpot.
2. Click **Customize** in the right panel, then **Customize the default view**.
3. Click **Add a card** and open the Card Library.
4. Search for **Whop** and add the card named **Whop Payment Link Deal** (or similar).
5. Drag it where you want it (e.g., near the top) and click **Save and Exit**.

**For contact records:** Use the same steps inside a contact record view. Deal and contact views can each have the Whop card in different positions.

### Generating a checkout session

1. Open the deal or contact where you want to collect payment.
2. Find the Whop payment card on the record.
3. Choose the **Product** from the dropdown (from your synced Whop products).
4. Choose the **Pricing Plan** (e.g., $2,000 one-time or $500/month recurring).
5. Click **Generate Checkout Session**.
6. Copy the unique checkout link and send it to the prospect, or use it to collect payment.

<Tip>
  The checkout link shows all payment methods enabled in your Whop account
  (including ACH, financing, and cryptocurrency if configured).
</Tip>

## How payment data appears in HubSpot

When a payment is made through a Whop checkout link generated from HubSpot, data is logged automatically in the following places.

### Payment records (Commerce Hub)

Every completed payment creates a native HubSpot payment record. View them under **Commerce Hub** → **Payments**. Each record includes:

* Payment ID
* Amount collected
* Card type and last four digits
* Association to the contact and/or deal
* Timestamp and transaction details

### Subscription records

For recurring payments, a HubSpot **subscription** record is created in addition to the payment record. It tracks the overall arrangement and recurring revenue. Fields include:

* Subscription status (Active, Unpaid, Delinquent)
* Last payment amount
* Total amount collected
* Monthly Recurring Revenue (MRR)
* Annual Recurring Revenue (ARR)
* Whop Membership ID
* Billing method

### Object associations

| Feature                | Description                                                    |
| ---------------------- | -------------------------------------------------------------- |
| Payment → Contact      | Automatically linked to the contact used for checkout.         |
| Payment → Deal         | Linked to the deal if checkout was started from a deal record. |
| Subscription → Contact | Subscription is associated with the contact.                   |
| Subscription → Payment | Individual payments are linked to their parent subscription.   |

<Tip>
  You don’t need to log payments or update deal stages manually. Data flows from
  Whop into HubSpot as soon as a payment is processed.
</Tip>

## Frequently asked questions

**Do I need a paid Whop account to use this integration?**

* No. Whop accounts are free.
* You only pay Whop's standard transaction fees on payments you process.

**What happens if my API key changes?**

* Go to HubSpot **Settings** → **Integrations** → **Connected Apps** → **Whop** → **Settings** and paste the new API key.
* The integration updates immediately.

**Can I use this with another payment processor in HubSpot?**

* Yes. Whop payments are separate and clearly labeled.
* In Commerce Hub → Payments you can filter to show only Whop transactions.

**What payment methods does Whop support?**

* Credit/debit cards, ACH, third-party financing (e.g., buy now pay later), and select cryptocurrencies.
* Whatever you enable in your Whop account appears on the checkout form.

**Is the Whop card available on both deal and contact records?**

* Yes. Add the card to the deal view and to the contact view separately; after that it's available on all records of that type.
* Setup is the same for both.

**Where can I see a full dashboard of all Whop payments?**

* Go to **Commerce Hub** → **Payments** in HubSpot to see every Whop payment as a native record.
* Subscription-level reporting and dashboards are covered in a separate guide.