New — webhooks your AI agents can wait on. Hook & Sense opening to early access.
Request access →

Lemon Squeezy Webhooks

Test Lemon Squeezy Webhooks Locally

Lemon Squeezy sends webhooks for subscription and payment events. Lemon Squeezy signs webhooks with HMAC-SHA256 using a secret you configure in your store settings.

With HookSense, point Lemon Squeezy at a callback endpoint and let an AI agent await the result over MCP: create_callback_endpoint → wait_for_callback → verify_signature. Run npx @hooksense/mcp in Claude Desktop, Cursor, or any MCP client. No polling.

Signature Header

X-Signature

Algorithm

HMAC-SHA256

Setup Guide

  1. 1Create a free HookSense endpoint at hooksense.com
  2. 2Copy your unique webhook URL
  3. 3In Lemon Squeezy Dashboard → Settings → Webhooks → Add webhook
  4. 4Paste your HookSense URL as the callback URL
  5. 5Enter a signing secret and save it — add the same secret to HookSense
  6. 6Select the events you want to receive
  7. 7Make a test purchase to trigger a webhook

Common Lemon Squeezy Webhook Events

order_created
order_refunded
subscription_created
subscription_updated
subscription_cancelled
subscription_payment_success
subscription_payment_failed
license_key_created

Forward to Localhost

Use HookSense CLI to forward Lemon Squeezy webhooks directly to your local development server:

npx hooksense listen -p 3000 --path /api/integrations/lemonsqueezy

No ngrok or tunnel setup required. Install with npm i -g hooksense or use npx.

Tips & Best Practices

  • Lemon Squeezy webhooks include a meta object with custom data from your checkout
  • Test mode webhooks use the same endpoint — use HookSense to tell them apart
  • Use replay to test subscription lifecycle events without making real purchases
  • Custom data passed via checkout is available in the webhook payload — inspect it in HookSense

Related

Lemon Squeezy Webhook Documentation HMAC Signature Calculator HMAC Verification Guide HookSense Documentation

Give your agent a Lemon Squeezy callback

Create a free callback endpoint and have an agent await its first verified Lemon Squeezy webhook over MCP. Paid plans are early-access.

Get Started Free