Event Types

This is the full list of webhook events available in Lemon Squeezy.


Event NameData SentDescription
order_createdOrder objectOccurs when a new order is successfully placed.
order_refundedOrder objectOccurs when a full or partial refund is made on an order.
subscription_createdSubscription objectOccurs when a new subscription is successfully created. An order_created event will always be sent alongside a subscription_created event.
subscription_updatedSubscription objectOccurs when a subscription’s data is changed or updated. This event can be used as a “catch-all” to make sure you always have access to the latest subscription data.
subscription_cancelledSubscription objectOccurs when a subscription is cancelled manually by the customer or store owner. The subscription enters a “grace period” until the next billing date, when it will expire. It is possible for the subscription to be resumed during this period.
subscription_resumedSubscription objectOccurs when a subscription is resumed after being previously cancelled.
subscription_expiredSubscription objectOccurs when a subscription has ended after being previously cancelled, or once dunning has been completed for past_due subscriptions. You can manage how long to wait before the system marks delinquent subscriptions as expired. More info
subscription_pausedSubscription objectOccurs when a subscription’s payment collection is paused.
subscription_unpausedSubscription objectOccurs when a subscription’s payment collection is resumed after being previously paused.
subscription_payment_successSubscription invoice objectOccurs when a subscription payment is successful.
subscription_payment_failedSubscription invoice objectOccurs when a subscription renewal payment fails.
subscription_payment_recoveredSubscription invoice objectOccurs when a subscription has a successful payment after a failed payment. A subscription_payment_success event will always be sent alongside a subscription_payment_recovered event.
subscription_payment_refundedSubscription invoice objectOccurs when a subscription payment is refunded.
license_key_createdLicense key objectOccurs when a license key is created from a new order. An order_created event will always be sent alongside a license_key_created event.
license_key_updatedLicense key objectOccurs when a license key is updated.

We suggest subscribing to these events as a minimum so that your application will have the latest data.

Single payment

order_created - This event lets you know when new orders are placed.

Subscriptions

subscription_created - This event lets you know when new subscriptions are created.

subscription_payment_success - This event lets you save billing histories for your subscribing customers.

subscription_updated - This event keeps your application up-to-date with all changes to a subscription.

Events sent during a subscription’s lifecycle

Different events will be triggered at various events during a subscription’s life.

You can see that subscription_updated is fired at every event after the initial payment. In most cases, subscribing to more granluar events like subscription_resumed or subscription_expired events as well as subscription_updated is not necessary.

Example 1: A typical flow of events

Initial order is placed:

  • order_created
  • subscription_created
  • subscription_payment_success
  • license_key_created (if licenses are enabled on the subscription product)

Successful renewal payment:

  • subscription_payment_success
  • subscription_updated

Payment method updated by customer:

  • subscription_updated

Subscription manually cancelled by the customer or store owner:

  • subscription_cancelled
  • subscription_updated

Subscription expires when the cancelled subscription reaches the ends_at date:

  • subscription_expired
  • subscription_updated

Example 2: With payment failures

Initial order is placed:

  • order_created
  • subscription_created
  • subscription_payment_success
  • license_key_created (if licenses are enabled on the subscription product)

Successful renewal payment:

  • subscription_payment_success
  • subscription_updated

Failed renewal payment (attempt 1):

  • subscription_payment_failed
  • subscription_updated

Successful renewal payment:

  • subscription_payment_success
  • subscription_payment_recovered
  • subscription_updated

Failed renewal payment (attempt 1):

  • subscription_payment_failed
  • subscription_updated

Failed renewal payment (attempt 2):

  • subscription_payment_failed
  • subscription_updated

Failed renewal payment (attempt 3):

  • subscription_payment_failed
  • subscription_updated

Failed renewal payment (attempt 4):

  • subscription_payment_failed
  • subscription_updated

(Subscription enters dunning)

Dunning finishes:

  • subscription_expired
  • subscription_updated

Was this page helpful?