Gumroad Automation

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 before

email -- Filter by customer email address

product_id -- Filter by specific product ID

page -- 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_restarted

post_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_id parameter. 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 page parameter.

Webhook deduplication: Before subscribing to a resource, use GUMROAD_GET_RESOURCE_SUBSCRIPTIONS to 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

---

Powered by Composio