Browse Plugins

Webhook Setup

All Lemon Squeezy for WordPress docs Get Lemon Squeezy for WordPress

What are Webhooks?

Webhooks notify your store instantly when payments are processed, refunds occur, subscription events happen, or license keys are generated. They’re essential for real-time order updates.

Option A: Automatic Registration (Recommended)

The easiest way to set up your webhook – one click and the plugin does everything for you.

1

Auto-Register Webhook

  1. Go to WooCommerce → Lemon Squeezy in the admin menu
  2. Find the “Webhook Setup” card
  3. Click “Register Webhook on Lemon Squeezy”
  4. The plugin will automatically:
    • Create the webhook endpoint on Lemon Squeezy
    • Subscribe to all necessary events
    • Store the signing secret in your settings
  5. You should see a success message confirming registration

Auto Register Webhook Button in Webhook Setup Card

Screenshot: Click “Register Webhook on Lemon Squeezy” – one click sets up everything

That’s It!

Auto-registration handles everything. No need to copy URLs or secrets between dashboards. You can skip to the Product Mapping section.

Option B: Manual Setup

If auto-registration doesn’t work or you prefer manual control, follow these steps instead.

1

Get Your Webhook URL

  1. In the plugin settings, find the “Webhook Setup” card
  2. Copy the Webhook URL displayed
  3. It looks like: https://yoursite.com/wp-json/wc-lemon-squeezy/v1/webhook
https://yoursite.com/wp-json/wc-lemon-squeezy/v1/webhook
Get Your Webhook URL

Screenshot: Get Your Webhook URL from WordPress Site

2

Add Webhook in Lemon Squeezy

  1. Go to Lemon Squeezy dashboard
  2. Navigate to Settings → Webhooks
  3. Click “Add Endpoint”
  4. Paste your webhook URL
  5. Select events based on what you’re selling:

Select Events Based on Your Products

Only check the events that match the type of products you’re selling. Don’t select subscription events if you only sell one-time purchases, and vice versa.

Required for All Stores:

order_created
order_refunded

If You Sell Products With License Keys:

license_key_created
license_key_updated

If You Sell Subscriptions:

subscription_created
subscription_updated
subscription_cancelled
subscription_resumed
subscription_expired
subscription_paused
subscription_unpaused
subscription_payment_success
subscription_payment_failed
subscription_payment_recovered

Lemon Squeezy Webhook Configuration

Screenshot: Lemon Squeezy Webhook Configuration

3

Copy Webhook Secret

  1. After saving webhook in Lemon Squeezy
  2. Copy the “Signing Secret”
  3. Return to WordPress plugin settings
  4. Paste it in “Webhook Secret” field
  5. Save settings

Security Critical!

The webhook secret validates that requests are genuinely from Lemon Squeezy. Every incoming webhook is verified using HMAC signatures. Never skip this step!