Prerequisites
- A Gumroad account at gumroad.com with at least one product
- A Ghost blog connected in PayGlue (Connect Ghost)
Steps
1
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.2
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.
3
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.
4
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.
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.[Screenshot — PayGlue Gumroad connection page: green confirmation “Webhook events registered with Gumroad automatically — nothing else to do.”]
5
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.
6
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.
7
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.
Supported events
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 itsresource_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.