---
title: "How to move Gumroad license keys and software buyers to Whop"
description: "Gumroad license keys can't be imported into Whop. Check both kinds of key on your server, give past buyers a free Whop claim link, then retire Gumroad's check."
url: https://movetowhop.com/guides/move-gumroad-license-keys-to-whop
updated: 2026-10-14
author: MoveToWhop
---

# How to move Gumroad license keys and software buyers to Whop

URL: https://movetowhop.com/guides/move-gumroad-license-keys-to-whop
Type: Guide · Updated 2026-10-14 · Facts checked 2026-10-14

> **Quick answer:** License keys can't be transferred. Whop issues its own key with each membership through its Software app, and its docs describe no way to bring your own. So you switch over instead: add a Whop check on your server, ship an app update that accepts either key, give past buyers a free Whop claim link that comes with a Whop key, and keep Gumroad's check running until a date you announce.

*We built MoveToWhop, the free tool this guide uses, and we may earn a referral commission from Whop if you create a Whop through our links. It costs you nothing.*

If you sell software, plugins or scripts on Gumroad, your app probably checks each buyer's Gumroad license key. Those keys can't come with you, so the move is a switchover: both kinds of key work for a while, every past buyer gets a Whop key, and then the Gumroad check goes. This guide covers the software side. The [full Gumroad to Whop plan](https://movetowhop.com/gumroad-to-whop) covers products, members and fees.

## Why keys can't be transferred

Gumroad generates its own keys; its help center says you either use those or manage keys outside Gumroad. On Whop, the key comes from the membership: Whop's docs say each purchase of a product that includes the Software app comes with a unique key, and the API only returns a key when the product has that app. And Whop's API can't create memberships directly. Its docs say checkout does that.

So nobody, including MoveToWhop, can carry a key string from Gumroad to Whop. What you can do is give every past buyer a free way through Whop checkout, which creates their membership and their new key.

## How the two checks compare

*From Gumroad's license key help article and Whop's SaaS docs, checked October 14, 2026.*

| | Gumroad | Whop |
|---|---|---|
| Where keys come from | The License key block on the product's content page | The Software app on the product |
| The check | `POST https://api.gumroad.com/v2/licenses/verify` with your product ID and the key | `memberships.retrieve` with the key in place of a membership ID |
| Secret needed | None: product ID and key | Your Whop API key, which can read and change every membership |
| Where it can run | Gumroad says the API accepts calls from the browser | Your own server only, never in the app you ship |
| Limiting use | A uses count that goes up on each verify unless you send `increment_uses_count=false` | One machine per key: you store a hardware ID in the membership's metadata |
| After a cancellation | The key stays enabled; `subscription_cancelled_at` fills in when the membership ends | The membership's status changes; Whop's example accepts active, trialing and completed |
| Unknown key | A 404 response | A 404 error |
| Resetting | Reset the uses count on the Sales page | Buyers reset from their orders, or your server clears the metadata |

The middle rows are the real work. If your app calls Gumroad straight from the user's machine today, the Whop check needs a small server endpoint that holds your Whop API key.

Video: [Gumroad to Whop with MoveToWhop](https://movetowhop.com/videos/gumroad-to-whop) (19-second demo with test data, transcript on the page)

*The free tool's Gumroad route with test data, from Sync to Move to Whop. Under 20 seconds, no sound.*

## Step 1: Export who owns which key

Download your sales CSV from Sales, then Export, with the date range set back to your first sale. Our [Gumroad export guide](https://movetowhop.com/how-to/export-members-from-gumroad) covers the details. Three columns are your key record:

- **License Key:** the key each buyer got
- **License Key Activation Count:** how many times it was verified
- **License Key Enabled?:** 1 if it still works

Keep this file. After the cutoff, it's how you answer "I bought this in 2024, what's my key?"

## Step 2: Create the product on Whop and add the Software app

Open the [free Gumroad to Whop tool](https://movetowhop.com/migrate?from=gumroad), pick Gumroad and press **Log in with Gumroad**. It reads your products, prices and buyers through Gumroad's API.
**Move to Whop** creates the products and plans, a hidden free claim plan for one-time buyers, and hidden trial-aligned plans for subscribers. It doesn't create license keys.

Then open the product on Whop and install the **Software** app. Add your software's name and download link. Whop's docs say buyers then see their key and the download in their orders.

## Step 3: Add a Whop key check on your server

Whop's SaaS docs lay out the check. In short, your server:

1. Creates an account API key under Developer, then API keys in your Whop dashboard, and keeps it on the server.
2. Looks up the key the app sends with `memberships.retrieve`, passing the key in place of a membership ID. An unknown key returns a 404.
3. Accepts the key only if the membership's status is active, trialing or completed. Add past_due if you let buyers keep access while Whop retries a failed renewal.
4. Binds the key to one machine: if the membership's metadata has no hardware ID, it saves the one the app sent; if it has one, the two must match.

Buyers can reset their key from their Whop orders. Your server can reset it too by clearing the membership's metadata.

## Step 4: Ship an app update that accepts either key

Change your app to send whatever key the user enters to your server, and have the server:

1. Try Whop first.
2. If Whop answers 404, call Gumroad's verify endpoint with your product ID and the key. Send `increment_uses_count=false` on repeat checks, so the uses count doesn't climb with every launch.
3. Treat a Gumroad key as valid while its purchase isn't refunded or disputed and, for subscriptions, while `subscription_cancelled_at`, `subscription_ended_at` and `subscription_failed_at` are empty.

Ship this update before you send any claim links, so a buyer who switches to a Whop key isn't locked out by an older version.

## Step 5: Give past buyers their Whop key

Send each past buyer their claim link from the Done screen's member list, with a short note: claim free access on Whop, find your new key in your Whop orders, enter it in the app. MoveToWhop doesn't send email for you, and our [announcement templates](https://movetowhop.com/guides/migration-announcement-templates) have wording.

- **One-time buyers** claim a hidden free plan on the product. Each claim creates a Whop membership with its own key.
- **Subscribers** claim a hidden plan at their current price, with a free trial that ends on their next Gumroad renewal. Our guide to [moving Gumroad members without double billing](https://movetowhop.com/guides/move-gumroad-subscribers-without-double-billing) covers cancelling them on Gumroad without breaking their key.

Claim one link yourself with a second email address first, and check that a key appears in your orders and that your updated app accepts it.

## Step 6: Retire the Gumroad check on an announced date

Pick a cutoff a few months out, tell buyers in your first email, and remind them twice. On the date, ship the update that removes the Gumroad fallback.

Until then, keep Gumroad running. Unpublish the product to stop new Gumroad sales; that keeps your buyers' purchases and data in place. Don't delete the product or the account while your app still checks Gumroad keys. A deleted product's sales also drop out of your sales export, which is your record of who owned which key.

## What doesn't move

- **Key strings.** Every buyer gets a new Whop key.
- **Activation counts and seats.** Whop's docs describe one machine per key, with no uses count or seat count.
- **Gumroad's license lookup page.** Buyers find Whop keys in their Whop orders instead.
- **Your verify code.** The Whop check is a new server endpoint, not a URL swap.

## Troubleshooting

| Problem | Likely cause | Fix |
|---|---|---|
| A claimed buyer has no key in their Whop orders | The product doesn't include the Software app | Add the Software app to the product |
| Your server gets a 404 for a key the buyer just claimed | The key is from Gumroad, or was mistyped | Fall back to Gumroad's verify, and check the key in their Whop orders |
| A buyer's key says it's bound to another machine | The hardware ID in metadata is from their old computer | Have them reset it from their Whop orders, or clear the metadata |
| Gumroad uses counts keep climbing | Each launch calls verify with the default settings | Send increment_uses_count=false on repeat checks |
| A subscriber's Gumroad key stopped working after you cancelled them | Your app locks keys once subscription_cancelled_at is set | Make sure they claimed their Whop key before their Gumroad period ended |

## Your software, live on Whop

Once your app accepts Whop keys and past buyers have claimed theirs, new sales run through Whop checkout and Whop issues every key. Weighing the move first? Compare [Whop and Gumroad](https://movetowhop.com/compare/whop-vs-gumroad), check the [Gumroad fees breakdown](https://movetowhop.com/pricing/gumroad-fees), or see the [Gumroad alternatives](https://movetowhop.com/alternatives/gumroad). Ready? [Start your free Gumroad to Whop move](https://movetowhop.com/migrate?from=gumroad).

## FAQs

### Can I import my Gumroad license keys into Whop?

No. Whop's docs describe keys that Whop issues itself, one with each purchase, when the product includes its Software app, and no way to bring your own key strings. Run both checks side by side until your buyers have Whop keys.

### Do I need a server to check Whop license keys?

Yes. Gumroad's verify call only needs your product ID and the key, so many apps call it directly. Whop's check uses your Whop API key, which can read and change every membership in your business, so Whop's docs say to run it on your own server and never ship it inside the app.

### Will my Gumroad keys stop working when I cancel a buyer's Gumroad membership?

Gumroad keeps the key enabled until you disable it. Once the membership ends, its verify response fills in subscription_cancelled_at. If your software locks keys on that field, give the buyer their Whop key before their Gumroad period ends.

### What about multi-seat Gumroad licenses?

Whop's software docs describe one key per membership, bound to one machine through a hardware ID you store, and no seat count. Before you send claim links, decide how you'll honor extra seats, for example by tracking seats per key on your own server.

### Does MoveToWhop move license keys?

No. MoveToWhop moves your products and prices and creates the claim links your past buyers use to join Whop. It doesn't move or use your keys. Each claim creates a Whop membership, and Whop issues the new key.

## Sources

- [Gumroad Help: License keys, verify API, browser calls, multi-seat keys, cancelled memberships (checked 2026-10-14)](https://gumroad.com/help/article/76-license-keys)
- [Gumroad Help: The sales analytics dashboard, License Key columns in the sales CSV (checked 2026-10-14)](https://gumroad.com/help/article/74-the-analytics-dashboard)
- [Gumroad source code: sales export columns (checked 2026-10-14)](https://github.com/antiwork/gumroad/blob/main/app/services/exports/purchase_export_service.rb)
- [Gumroad Help: The sales dashboard, managing license keys (checked 2026-10-14)](https://gumroad.com/help/article/268-customer-dashboard)
- [Gumroad Help: Delete or unpublish a product (checked 2026-10-14)](https://gumroad.com/help/article/248-delete-a-product)
- [Whop Docs: SaaS, license key integration with the Software app (checked 2026-10-14)](https://docs.whop.com/supported-business-models/saas)
- [Whop Docs: Memberships, created at checkout (checked 2026-10-14)](https://docs.whop.com/developer/guides/memberships)

## Related

- https://movetowhop.com/gumroad-to-whop
- https://movetowhop.com/how-to/export-members-from-gumroad
- https://movetowhop.com/guides/move-gumroad-subscribers-without-double-billing
- https://movetowhop.com/compare/whop-vs-gumroad
- https://movetowhop.com/pricing/gumroad-fees
- https://movetowhop.com/alternatives/gumroad

---
MoveToWhop is independent and not affiliated with Whop, Inc. We may earn a referral commission from Whop when you create a Whop through our links.

Open this page: https://movetowhop.com/guides/move-gumroad-license-keys-to-whop
