Gumroad Automation
Automate your Gumroad storefront -- list products, track sales, verify licenses, and manage real-time webhooks -- all through natural language commands.
Toolkit docs: [composio.dev/toolkits/gumroad](https://composio.dev/toolkits/gumroad)
---
Setup
- Add the Composio MCP server to your client configuration:
https://rube.app/mcp- Connect your Gumroad account when prompted (API key authentication).
- Start issuing natural language commands to manage your Gumroad store.
---
Core Workflows
1. List All Products
Retrieve every product in your authenticated Gumroad account to get product IDs for downstream operations.
Tool: GUMROAD_LIST_PRODUCTS
Example prompt: > "List all my Gumroad products"
Parameters: None required -- returns all products for the authenticated account.
---
2. Track Sales with Filters
Retrieve successful sales with optional filtering by email, date range, product, or pagination.
Tool: GUMROAD_GET_SALES
Example prompt: > "Show me all Gumroad sales from January 2025 for product prod_ABC123"
Key parameters:
after-- ISO8601 date/time to filter sales after (e.g.,2025-01-01T00:00:00Z)before-- ISO8601 date/time to filter sales beforeemail-- Filter by customer email addressproduct_id-- Filter by specific product IDpage-- Page number for paginated results (minimum 1)
---
3. Verify License Keys
Check if a license key is valid against a specific product, inspect usage count, or verify membership entitlement.
Tool: GUMROAD_VERIFY_LICENSE
Example prompt: > "Verify license key ABCD-EFGH-IJKL-MNOP for product prod_ABC123"
Key parameters (all required):
product_id-- The product ID to verify against (required for products created on/after Jan 9, 2023)license_key-- The license key string (e.g.,ABCD-EFGH-IJKL-MNOP)increment_uses_count-- Whether to increment usage count (defaults to true)
---
4. Subscribe to Webhook Events
Set up real-time event notifications by subscribing your endpoint URL to specific Gumroad resource events.
Tool: GUMROAD_SUBSCRIBE_TO_RESOURCE
Example prompt: > "Subscribe my webhook https://example.com/hook to Gumroad sale events"
Key parameters (all required):
resource_name-- One of:sale,refund,dispute,dispute_won,cancellation,subscription_updated,subscription_ended,subscription_restartedpost_url-- Your endpoint URL that receives HTTP POST notifications
---
5. List Active Webhook Subscriptions
Review existing webhook subscriptions for a given resource type before adding new ones to avoid duplicates.
Tool: GUMROAD_GET_RESOURCE_SUBSCRIPTIONS
Example prompt: > "Show all my active Gumroad webhook subscriptions for sale events"
Key parameters (required):
resource_name-- One of the eight supported event types (e.g.,sale,refund)
---
Known Pitfalls
- Product ID required for license verification: Products created on or after January 9, 2023 require the
product_idparameter. Older products may work without it but providing it is recommended. - Pagination on sales: Sales results are paginated. Always check if more pages exist by incrementing the
pageparameter. - Webhook deduplication: Before subscribing to a resource, use
GUMROAD_GET_RESOURCE_SUBSCRIPTIONSto check for existing subscriptions and avoid duplicate webhooks. - ISO8601 date format: Date filters on sales must use ISO8601 format (e.g.,
2025-01-01T00:00:00Z), not plain dates.
---
Quick Reference
| Action | Tool Slug | Required Params | |---|---|---| | List products | GUMROAD_LIST_PRODUCTS | None | | Get sales | GUMROAD_GET_SALES | None (all optional filters) | | Verify license | GUMROAD_VERIFY_LICENSE | product_id, license_key | | Subscribe to events | GUMROAD_SUBSCRIBE_TO_RESOURCE | resource_name, post_url | | List webhook subs | GUMROAD_GET_RESOURCE_SUBSCRIPTIONS | resource_name |
---
*Powered by [Composio](https://composio.dev)*