hellcat123git/TCS-TechDay / .agents/skills/composio-skills/gumroad-automation
Gumroad Automation
VerifiedAutomate Gumroad product management, sales tracking, license verification, and webhook subscriptions using natural language through the Composio MCP integration.
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
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
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 465k | Updated | Claude CodeCodex | Verified | Install |
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 465k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 318k | Updated | Claude CodeCodex | Verified | Install |