Guides · commerce · Popular APIs

Gumroad API

REST API (v2) for a Gumroad creator account. Create an application under Settings > Advanced; for your own account, generate a personal access token there instead of running OAuth. Gumroad is the merchant of record for sales.

Researched · not yet run liveLast researched 25 October 2026 · Gumroad · provider site

Researched, not yet run live. Built from the provider’s official pages (linked below). A person hasn’t walked this flow end to end yet, so check each step against the source.

Who owns what

One Gumroad creator account. Applications (OAuth clients) live under the account's Settings > Advanced; a personal access token acts as the account.

  • Gumroad account personal owned by the creator (person or business)
  • API application developer · under Gumroad accountNeeded both for OAuth (third-party users) and to generate a personal access token.

Have ready

  • A Gumroad creator account selling products allowed by Gumroad's prohibited-products list
  • Government-issued ID and personal/tax details, if Gumroad or its payment processor asks. · Gumroad may request legal name, address, date of birth, taxpayer ID, bank details and government ID, and may hold funds until provided. [3]Needed for: Fill in payout settings
  • Bank account (or another payout method) for payouts. [3]Needed for: Fill in payout settings

Steps

Steps marked “human step” are ones only you can do: verapli never signs in, submits, pays or accepts terms for you.

  1. Create a Gumroad account

    The person signs up at Gumroad and accepts the terms.

    • Guided by hand
    • Human step: You accept the terms

    Where: https://gumroad.com/signup

  2. Create an API application

    In Settings > Advanced, fill in the application form (name, redirect URI). For your own account only, the redirect URI can be http://127.0.0.1.

    • verapli co-pilot
    • Human step: You press submit
    • After: Create a Gumroad account

    verapli captures GUMROAD_APPLICATION_ID here by plain code: encrypted in your browser, never shown to AI.

    Where: https://gumroad.com/settings/advanced

  3. Copy the application secret (OAuth only)optional

    If other Gumroad users will connect through OAuth, copy the application secret for the server-side token exchange. Not needed for a personal access token.

    • verapli co-pilot
    • After: Create an API application

    verapli captures GUMROAD_APPLICATION_SECRET here by plain code: encrypted in your browser, never shown to AI.

    Where: https://gumroad.com/settings/advanced

  4. Generate an access token for your own account

    Click "Generate access token" on the application. The token works until revoked; store it as a secret.

    • verapli co-pilot
    • Human step: You press submit
    • After: Create an API application

    verapli captures GUMROAD_ACCESS_TOKEN here by plain code: encrypted in your browser, never shown to AI.

    Where: https://gumroad.com/settings/advanced

  5. Fill in payout settingsoptional

    Add payout details in the payout settings; Gumroad or its processor may ask for identity documents before paying out.

    • Guided by hand
    • Human step: You prove your identity
    • After: Create a Gumroad account
    If something goes wrong (1)
    • Payouts held.: Provide the verification information Gumroad requests; funds can be held until it is supplied. [3]

Terms and gotchas

Plain-English summary, not legal advice. Each card links its source.

Can cost moneyThe rules say

Gumroad is the merchant of record

Gumroad is the merchant of record for the resale of your products; you may not invoice buyers directly; Gumroad sets the final resale price (from your suggested price), handles first-tier refunds/chargebacks, and collects and remits indirect tax. [3]

Can get you bannedThe rules say

Prohibited products

Prohibited include restricted goods (alcohol, tobacco, weapons), adult content and dating, AI services fulfilled outside Gumroad (AI tools, chatbots, generation subscriptions), crypto/NFTs and monetizable credits, financial and money services, get-rich-quick and credit-repair schemes, gambling and betting tips, pharmaceuticals, pirated goods, hacking and game cheats, fake IDs, bulk marketing tools and email lists, MLM, food/plants/seeds, jewelry and beauty products, and more. [4]

Can cost moneyThe rules say

Holds, reserves and discretionary termination

Gumroad may hold payouts for risk reasons with no fixed maximum, applies a 25% rolling 90-day reserve if the refund rate exceeds 15%, and may suspend or terminate accounts at any time in its sole discretion. [3]

Worth knowingThe rules say

No scraping or excessive load

The terms prohibit automated scraping, crawling or data mining and imposing excessive load; API use should stay within normal application behaviour. [3]

What you end up with

Env varSecretFormatWhat it is
GUMROAD_ACCESS_TOKENsecretopaque token string (shape only)Access token for your own Gumroad account; does not expire until revoked.
GUMROAD_APPLICATION_IDnot secretopaque id stringOAuth application id (client id).
GUMROAD_APPLICATION_SECRETsecretopaque secret string (shape only)OAuth application secret (server side only).

Pricing

  • Free tier: No monthly fee.
  • Costs: 10% + $0.50 per direct sale; 30% per Discover sale.

Source [5]

For agents

The same entry as JSON: /api/v1/entries/gumroad/api · requirements /api/v1/requirements/gumroad/api · terms /api/v1/terms/gumroad/api.

Remote MCP (read-only, no auth)
claude mcp add --transport http verapli https://verapli.com/mcp

> "What do I need for Gumroad API, and how long will it take?"
  → tools/call requirements { "provider_id": "gumroad/api" }

Sources

  1. Create an application for the API (Gumroad Help Center) Create an application in Settings > Advanced; for personal use the redirect URI can be http://127.0.0.1; "Generate access token" gives a token for your own account; example GET https://api.gumroad.com/v2/products with access_token; token does not expire until revoked. (Page is script-rendered; content read via search snippet of the official article [to verify on page].) · accessed 25 October 2026 · official
  2. Gumroad API documentation Official API reference location. · accessed 25 October 2026 · official
  3. Gumroad Terms of Service Gumroad is merchant of record for resale of products (6.1); suppliers may not invoice buyers directly; Gumroad collects and remits tax (10.2); may request identity information including government ID, tax id and bank details (4.2) and hold funds if not provided (11.3(c)); refund-rate reserves (11.3(b)); suspension at sole discretion (23.4); prohibits scraping and excessive load (14). · accessed 25 October 2026 · official
  4. Gumroad prohibited products List of prohibited products and activities. · accessed 25 October 2026 · official
  5. Gumroad pricing 10% + $0.50 per direct sale; 30% for Discover sales; no monthly fee. · accessed 25 October 2026 · official

Provider rules change. This page is generated from verapli registry version 2026.1025.316; spotted something out of date? Tell us. Gumroad is not affiliated with verapli.