3.3 KiB
3.3 KiB
Gumroad Routing Reference
App name: gumroad
Base URL proxied: api.gumroad.com
API Path Pattern
/gumroad/v2/{resource}
Common Endpoints
Get Current User
GET /gumroad/v2/user
List Products
GET /gumroad/v2/products
Get Product
GET /gumroad/v2/products/{product_id}
Update Product
PUT /gumroad/v2/products/{product_id}
Content-Type: application/x-www-form-urlencoded
name=Updated%20Name
Delete Product
DELETE /gumroad/v2/products/{product_id}
List Sales
GET /gumroad/v2/sales
GET /gumroad/v2/sales?after=2026-01-01&before=2026-12-31
Get Sale
GET /gumroad/v2/sales/{sale_id}
List Subscribers
GET /gumroad/v2/products/{product_id}/subscribers
Get Subscriber
GET /gumroad/v2/subscribers/{subscriber_id}
Verify License
POST /gumroad/v2/licenses/verify
Content-Type: application/x-www-form-urlencoded
product_id={product_id}&license_key={license_key}
Enable/Disable License
PUT /gumroad/v2/licenses/enable
PUT /gumroad/v2/licenses/disable
List Resource Subscriptions (Webhooks)
GET /gumroad/v2/resource_subscriptions?resource_name=sale
Resource names: sale, refund, dispute, dispute_won, cancellation, subscription_updated, subscription_ended, subscription_restarted
Create Resource Subscription
PUT /gumroad/v2/resource_subscriptions
Content-Type: application/x-www-form-urlencoded
resource_name=sale&post_url=https://example.com/webhook
Delete Resource Subscription
DELETE /gumroad/v2/resource_subscriptions/{resource_subscription_id}
Offer Codes
GET /gumroad/v2/products/{product_id}/offer_codes
POST /gumroad/v2/products/{product_id}/offer_codes
PUT /gumroad/v2/products/{product_id}/offer_codes/{offer_code_id}
DELETE /gumroad/v2/products/{product_id}/offer_codes/{offer_code_id}
Variant Categories
GET /gumroad/v2/products/{product_id}/variant_categories
POST /gumroad/v2/products/{product_id}/variant_categories
DELETE /gumroad/v2/products/{product_id}/variant_categories/{variant_category_id}
Variants
GET /gumroad/v2/products/{product_id}/variant_categories/{variant_category_id}/variants
POST /gumroad/v2/products/{product_id}/variant_categories/{variant_category_id}/variants
PUT /gumroad/v2/products/{product_id}/variant_categories/{variant_category_id}/variants/{variant_id}
DELETE /gumroad/v2/products/{product_id}/variant_categories/{variant_category_id}/variants/{variant_id}
Custom Fields
GET /gumroad/v2/products/{product_id}/custom_fields
POST /gumroad/v2/products/{product_id}/custom_fields
PUT /gumroad/v2/products/{product_id}/custom_fields/{name}
DELETE /gumroad/v2/products/{product_id}/custom_fields/{name}
Pagination
Page-based pagination:
GET /gumroad/v2/sales?page=1
GET /gumroad/v2/sales?page=2
Notes
- All responses include
successboolean field - Product creation not available via API
- POST/PUT use
application/x-www-form-urlencoded(not JSON) - Prices in cents (500 = $5.00)
- License keys are case-insensitive