For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling — append .md to any URL.
Webhooks let you get notified for when events happen in Paddle. They're also called notifications.
Listen to your first event
If you're building subscription billing, these are the events you need. See the provisioning guide for implementation details.
A new customer. Store customer details on signup.
A customer completed a purchase. Paddle automatically creates a subscription for any recurring items. Use this to confirm payment and start fulfillment.
A new subscription. Save the customer and subscription IDs against your user, and grant access.
Catch-all for subscription state changes, including renewals, upgrades, downgrades, pauses, resumes, and cancellations. Parse the state change, store updates, and adjust access.
Customer details changed. Update your stored copy.
Define what you sell.
People and businesses you bill.
Charge customers and reconcile.
Authenticate requests and stay aligned with operations.