Webhooks let you get notified when things happen in Paddle. They're also called notifications.
Webhooks let you subscribe to events in Paddle. When a subscribed event occurs, Paddle sends a notification that includes a JSON payload with the updated entity.
They're great for things like:
- Managing access to features in your app depending on a customer's subscription or invoice status
- Syncing information with other systems that your business uses, like a CRM or ERP solution
- Setting up notifications or automations
You can set up URLs to receive webhooks and the types of events you'd like to get from your Paddle dashboard under Developer Tools > Notifications.
The server that you set to receive events from Paddle should respond with an HTTP 200 status code within 5 seconds. This lets Paddle know that you successfully received the message.
If your server sends another kind of status code or doesn't respond, Paddle automatically retries using an exponential backoff schedule. We retry 60 times for just under 3 days. The first 20 attempts happen in the first hour, with 47 in the first day and 60 overall.
Use an exponential backoff calculator to visualize retries from the date now. Use these values:
To make sure you receive events from Paddle, we recommend that you add Paddle webhook IP addresses to your allowlist.
123456184.108.40.206 220.127.116.11 318.104.22.168 422.214.171.124 5126.96.36.199 6188.8.131.52
For security, only trust events that originate from Paddle webhook IP addresses.
Paddle-Signature header included with each webhook to verify that received events are genuinely sent by Paddle.