Gumroad

Gumroad

This connector reads your Gumroad store through the official Gumroad API v2 (https://api.gumroad.com/v2): your profile, products, sales with filters, subscribers of memberships, offer codes, custom checkout fields, license keys and the webhooks (resource subscriptions) set up for your account. It can also publish or unpublish a product and create an offer code, after you confirm.

Setup (about 3 minutes)

1. Sign in to Gumroad and open Settings, Advanced, Applications (https://gumroad.com/settings/advanced#application-form).
2. Create an application: any name, and any https address as redirect URI (it is not used here), then click Create application.
3. On the application, click Generate access token and copy the token into GUMROAD_ACCESS_TOKEN.
4. Install and run gumroad_get_user.

What the token can do: a generated token carries every scope Gumroad offers (read products and sales, edit products, and also refund sales). This connector only uses what its tools need: refunds are installed switched off, and there is no tool that deletes a product, an offer code or a custom field. Keep the token private; anyone who has it can manage your store. To revoke it, delete the application or generate a new token.

Writes: confirm first. gumroad_enable_product publishes a product (it goes on sale), gumroad_disable_product takes it off sale, and gumroad_create_offer_code creates a discount code customers can use right away. Show the user what will change and wait for a clear yes before calling. gumroad_refund_sale is installed switched off: refunds send money back to the buyer and cannot be undone; it only does anything if an admin switches it on.

Customer data is personal data. Sales and subscribers carry buyers' e-mail addresses, names and license keys. Read only what the user asks for and do not copy it elsewhere.

How to work

1. gumroad_get_user for the account, gumroad_list_products for product ids, names, prices and sales counts; gumroad_get_product for one product with its description and variants.
2. Sales: gumroad_list_sales with filters (after, before as YYYY-MM-DD, product_id, email, order_id, name, license_key), then gumroad_get_sale for one. Gumroad returns 10 sales per page; for more, call again with page_key = next_page_key until it is missing. To total revenue over a long period, page through and add up, and tell the user how many sales you counted.
3. Memberships: gumroad_list_subscribers for one product (100 per page, page_key again), gumroad_get_subscriber for one.
4. Discounts: gumroad_list_offer_codes, gumroad_create_offer_code.
5. Checkout questions: gumroad_list_custom_fields.
6. License keys: gumroad_verify_license checks a key for a product without counting a use (unless you ask it to).
7. Webhooks: gumroad_list_resource_subscriptions for one event type (sale, refund, dispute, dispute_won, cancellation, subscription_updated, subscription_ended, subscription_restarted).

Money: amounts such as price, gumroad_fee, amount_cents, sales_usd_cents are in cents (or the smallest unit of the product's currency); formatted_total_price is ready to show. Dates are ISO 8601 in UTC.

Errors: Gumroad answers some failures with success: false and a message, e.g. "The product was not found."; the connector turns those into errors. 401 means the token is wrong or revoked; 404 from gumroad_verify_license means the license key does not exist for that product, was disabled, or its purchase lost access.

Out of scope: creating, editing or deleting products, variants and files, refunds (switched off), marking sales as shipped, revoking access, resending receipts, payouts and tax forms, e-mails and workflows, and creating or deleting webhooks.