Gumroad API
★ Only Publicly Available OpenAPI DocumentE CommerceStorefrontbearer26 EndpointsREST
For Agents
Manage Gumroad products, offer codes, licences, subscribers, sales, and webhooks for digital storefronts and software vendors.
Use for: I need to create a new digital product on Gumroad, Generate a license key for a software product I sold, Verify a customer's Gumroad license key is valid, List recent sales of a Gumroad product
Not supported: Does not handle physical-goods fulfilment, tax calculation, or merchant-of-record remittance — use for digital products, licences, and creator storefronts on Gumroad only.
Jentic publishes the only available OpenAPI specification for Gumroad API, keeping it validated and agent-ready. Gumroad's API exposes the digital marketplace's core resources for selling downloads, courses, memberships, and software licences. The 26-endpoint surface covers product creation and management, offer codes, license key generation and verification, sales and subscriber lookups, custom fields, webhooks, and the authenticated user record. Authentication is via bearer access token from the Gumroad app.
Install Jentic One Beta
Connect the Gumroad API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Gumroad API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Gumroad API.
Create digital product listings with price, name, and description, then enable or disable them
Issue and disable percentage or fixed-amount offer codes against a specific product
Generate, verify, and decrement license keys for software unlocks and seat-based access
Look up sales records and individual subscriber details for membership products
Define custom fields collected at checkout and read responses on each sale
Register webhook subscriptions for sale and subscription lifecycle events
Use Cases
Patterns agents use Gumroad API for, with concrete tasks.
★ Software licence issuance and verification
Sell software through Gumroad and gate features behind license-key verification. After purchase, generate a license key tied to the product and validate it from the application on each launch. Optionally decrement remaining uses for seat-limited or trial keys. This replaces a custom licensing service for indie and small-team software.
Call POST /licenses/verify with the product permalink and license key, return whether the key is valid, and decrement remaining uses if applicable.
Promo code campaigns
Run time-limited promotions on a Gumroad catalogue by creating per-product offer codes with percentage or fixed discounts and a maximum redemption count. The API lets a marketing service create codes in bulk, list them for a dashboard, and disable them when a campaign ends. Useful for launches, bundle deals, and influencer partnerships.
Create an offer code 'LAUNCH20' with 20 percent off product abc and a 500-redemption cap via POST /products/{product_id}/offer_codes.
Sales and subscriber reporting
Build a finance or operations dashboard that pulls Gumroad sales and subscriber records to reconcile revenue and track membership status. The Sales endpoint returns one-time purchases with custom-field responses, while Subscribers covers recurring memberships. Useful for closing the books and detecting failed renewals.
List GET /sales for the last 30 days and aggregate gross revenue per product.
AI agent fulfilment via Jentic
An AI assistant in a vendor's support inbox handles a 'where is my license' request by looking up the customer's sale, fetching the issued license key, and replying with verification instructions. Through Jentic the agent loads the right Gumroad operations on demand instead of hard-coding the SDK.
Search Jentic for 'verify a gumroad license key', load the operation, and validate the key for product 'pro-app' against email customer@example.com.
Key Endpoints
26 endpoints — jentic publishes the only available openapi specification for gumroad api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
POST
/products
Create a product
GET
/products
List products
POST
/products/{product_id}/offer_codes
Create an offer code
GET
/products/{product_id}/offer_codes
List offer codes for a product
POST
/products
Create a product
GET
/products
List products
POST
/products/{product_id}/offer_codes
Create an offer code
GET
/products/{product_id}/offer_codes
List offer codes for a product
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Gumroad bearer access tokens are stored encrypted in the Jentic vault. Agents receive scoped execution access — the raw token never enters the agent's prompt or tool input.
Intent-based discovery
Agents search Jentic by intent (e.g., 'verify a gumroad license key') and Jentic returns the matching Gumroad operation with its input schema so the agent calls the right endpoint without parsing docs.
Time to first call
Direct integration: 1-2 days to wire auth, license verification, and webhook signature validation. Through Jentic: under an hour — search, load, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
Alternative
Stripe
General-purpose payments and billing platform with broader product surface
Choose Stripe when you need a fully customisable checkout, complex tax handling, or non-digital products that fall outside Gumroad's hosted storefront.
FAQs
Specific to using Gumroad API through Jentic.
Why is there no official OpenAPI spec for Gumroad API?
Gumroad does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Gumroad API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Gumroad API use?
Gumroad uses bearer access tokens generated from the user's Gumroad account. Pass the token as Authorization: Bearer <token>. Jentic stores the token encrypted in the vault and provides scoped execution tokens to the agent.
Can I verify a software license key with the Gumroad API?
Yes. Use the licenses verify operation under /licenses/verify with the product permalink and license key. The response indicates whether the key is valid and how many uses remain, suitable for app activation flows.
Can I create discount codes programmatically with the Gumroad API?
Yes. POST /products/{product_id}/offer_codes creates an offer code scoped to a single product with either a percentage or fixed amount discount, an optional maximum redemption count, and an active flag. Use PUT and DELETE on the same path to update or remove.
What are the rate limits for the Gumroad API?
Gumroad does not publish hard rate-limit numbers. In practice expect throttling under sustained automated use; back off on 429 responses and batch reads where possible. Webhooks are the recommended route for high-frequency sale notifications instead of polling.
How do I list recent sales with the Gumroad API through Jentic?
Search Jentic for 'list gumroad sales', load the GET /sales operation, then execute it with optional date filters. Install with pip install jentic.
GET STARTED