Skip to main content

Gumroad

Available

This integration is active and ready to use in Frihet.

Connect your Gumroad account to Frihet. Import products and sales from your digital store, generate automatic invoices, and consolidate your creator income with the rest of your invoicing.

What does it do?​

With Gumroad integrated:

  • Import products — Bring your Gumroad catalog to Frihet
  • Import sales — Each sale becomes an income record
  • Automatic invoices — Generate invoices for each sale with buyer data
  • Deduplication — Already imported sales are not duplicated
  • GR- Prefix — Imported sales are identified with the GR- prefix for easy tracking
  • Refund status — Refunds in Gumroad are automatically reflected

Requirements​

  • Active Gumroad account — gumroad.com
  • API Access Token — Generated from Gumroad settings
  • Frihet Pro or higher

Connect Gumroad with Frihet​

Step 1: Get your Access Token​

  1. Go to app.gumroad.com/settings/advanced
  2. Log in to your Gumroad account
  3. In the Applications section, look for Access Token
  4. If you don't have one, click on Create application:
    • Name: "Frihet ERP"
    • Redirect URI: https://app.frihet.io (not used, but mandatory)
  5. Copy the generated Access Token

Step 2: Configure in Frihet​

  1. Go to Settings → Integrations
  2. Search for Gumroad
  3. Click on Connect
  4. Paste your Access Token
  5. Click on Verify connection
  6. If correct, you will see your Gumroad profile name

Step 3: Verify connection​

  1. Frihet will show an account summary:
    • Number of active products
    • Recent sales
  2. Perform a test import to verify everything works

How it works​

Frihet uses the Gumroad API with Bearer authentication:

  1. You provide your Access Token
  2. Frihet sends the token in the Authorization: Bearer <token> header
  3. Products and sales are imported on demand
  4. Each imported sale receives an identifier with the GR- prefix (e.g.: GR-abc123)
  5. Deduplication is based on the Gumroad sale ID: if a sale has already been imported, it is not duplicated
  6. The token is stored encrypted (AES-256-GCM) in Frihet

Synchronized data​

DataDirectionFrequency
ProductsGumroad → FrihetOn demand
SalesGumroad → FrihetOn demand
Buyer dataGumroad → FrihetWith each sale
Refund statusGumroad → FrihetWith each import
Price and currencyGumroad → FrihetWith each sale

Status mapping​

Gumroad StatusFrihet Status
Sale completedIncome recorded
Partial refundIncome adjusted
Full refundIncome voided / credit note

Use cases​

Digital creator with ebooks and courses​

You sell ebooks, templates, and courses on Gumroad. Each sale is automatically imported into Frihet with buyer data, generating an income record that you can invoice and declare.

Freelancer selling templates​

In addition to your consulting services, you sell templates on Gumroad. Frihet consolidates your service income (manual invoices) with your digital product income (imported from Gumroad) in a single dashboard.

Refund control​

A buyer requests a refund on Gumroad. Upon re-importing sales, Frihet detects the status change and adjusts the income record to reflect the refund.

Import products​

  1. Go to Settings → Integrations → Gumroad
  2. Click on Import products
  3. Frihet will fetch all your active products from Gumroad
  4. Products will appear in your Frihet catalog

Data imported per product:

  • Product name
  • Price
  • Description
  • Status (active/inactive)

Import sales​

  1. Go to Settings → Integrations → Gumroad
  2. Click on Import sales
  3. Select the date range
  4. Frihet will import sales and create income records

Each imported sale includes:

  • Sale ID with GR- prefix (e.g.: GR-xYz123)
  • Buyer name and email
  • Product sold
  • Amount and currency
  • Sale date
  • Status (completed / refunded)

Automatic retries​

If an import fails due to a temporary error (timeout, server error), Frihet automatically retries up to 3 times with exponential backoff (1s, 2s, 4s). You don't need to do anything — retries are transparent.

Troubleshooting​

"Authentication error"​

  • Verify that the Access Token is correct
  • Check that your Gumroad account is active
  • If you regenerated the token, update it in Frihet

"My sales are not importing"​

  • Check that you have sales in the selected date range
  • Very old sales may take longer to import
  • Verify that the Access Token has read permissions

"I see duplicate sales"​

  • This should not happen: Frihet deduplicates by Gumroad sale ID
  • If it occurs, disconnect and reconnect the integration
  • Sales already recorded in Frihet will not be affected

"A refund is not reflected"​

  • Import sales again for Frihet to detect the status change
  • The refund must be processed in Gumroad (not just requested)

Next steps​