> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payglue.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Gumroad

> Connect Gumroad as a payment provider in PayGlue.

Gumroad is a fully supported payment provider in PayGlue. When a customer buys your product or starts a subscription, PayGlue automatically creates or updates the matching Ghost member — no manual webhook setup required.

## Prerequisites

* A Gumroad account at [gumroad.com](https://gumroad.com) with at least one product
* A Ghost blog connected in PayGlue ([Connect Ghost](/ghost/connect))

## Steps

<Steps>
  <Step title="Open Applications in Gumroad">
    In your Gumroad account, click your avatar in the top right and go to **Settings**. Open the **Advanced** tab and scroll down to the **Applications** section.

    Click **Create application**.

    > \[Screenshot — Gumroad Settings → Advanced → Applications section with "Create application" button]

    Fill in a name (e.g. `PayGlue`) and confirm. The application runs entirely within your own Gumroad account — no review or approval by Gumroad is required.
  </Step>

  <Step title="Copy Application ID and Application Secret">
    After creating the application, Gumroad shows your **Application ID** and **Application Secret**.

    > \[Screenshot — Gumroad Applications list: Application ID and Application Secret fields for the newly created application]

    Copy both values — you will need them in Step 4.
  </Step>

  <Step title="Generate an Access Token">
    Next to your new application, click **Generate access token**. This creates a personal token that allows PayGlue to read your sale data and register webhook events on your behalf.

    > \[Screenshot — Gumroad application row with "Generate access token" button and the resulting token field]

    Copy the token. It is shown only once — store it safely before leaving the page.
  </Step>

  <Step title="Enter credentials in PayGlue">
    In your PayGlue dashboard, go to **Providers** and click **Connect Gumroad**.

    Fill in the three fields:

    * **Application ID** — from Step 2
    * **Application Secret** — from Step 2
    * **Access Token** — from Step 3

    > \[Screenshot — PayGlue dashboard: Gumroad connection page with Application ID, Application Secret, and Access Token fields]

    Click **Save credentials**.

    <Note>
      PayGlue automatically registers the necessary webhook events (`sale`, `cancellation`, `subscription_ended`) with Gumroad the moment you save. You do not need to configure anything further in Gumroad. A confirmation message appears below the button once registration succeeds.
    </Note>

    > \[Screenshot — PayGlue Gumroad connection page: green confirmation "Webhook events registered with Gumroad automatically — nothing else to do."]
  </Step>

  <Step title="Run a health check">
    Click **Run health check** to confirm PayGlue can connect to your Gumroad account using the saved credentials.

    A green "Connection established" banner means everything is working correctly.
  </Step>

  <Step title="Create a mapping">
    Go to **Buy Button**, **Paywall**, or **Pricing Table** in your PayGlue dashboard and select your Gumroad product from the dropdown. Choose which Ghost newsletter to subscribe the buyer to and which welcome email to send, then save.

    From this point on, every Gumroad purchase triggers automatic Ghost member creation.
  </Step>

  <Step title="Test your setup">
    Make a test purchase on one of your Gumroad products. Then open **Analytics → Webhook Events** in your PayGlue dashboard — the event should appear with status **Processed** and the buyer's email should appear as a new member in Ghost Admin.
  </Step>
</Steps>

## Supported events

| Gumroad event                 | PayGlue action              |
| ----------------------------- | --------------------------- |
| `sale` (new purchase)         | Create Ghost member         |
| `sale` (subscription renewal) | Confirm active Ghost member |
| `cancellation`                | Revoke Ghost member access  |
| `subscription_ended`          | Revoke Ghost member access  |

## Troubleshooting

**Webhook registration fails after saving credentials**

Check that the Access Token has not expired and belongs to the same Gumroad account that owns the products. After fixing the token, click **Save credentials** again — PayGlue retries registration automatically.

**Products do not appear in the dropdown**

Make sure the health check passes. If credentials are invalid, PayGlue cannot load your product list.

**Ghost member is not created after a purchase**

Open the event in **Analytics → Webhook Events** and check the error message. The most common cause is a missing mapping — PayGlue receives the event but takes no action unless there is an active mapping for that product.

***

## Webhook signature verification

Gumroad does not currently attach a cryptographic signature to the webhook deliveries sent via its `resource_subscriptions` mechanism. PayGlue stores your Application Secret and will verify the `X-Gumroad-Signature` header automatically if Gumroad starts sending one — no action needed on your part. Until then, the per-tenant webhook URL itself acts as the shared secret between Gumroad and PayGlue.