Webhooks
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:
- 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.
Respond to events
Section titled “Respond to events”The server that you set to receive events from Paddle should respond with a HTTP 200 status code within 10 seconds. This lets Paddle know that you successfully received the message.
If your server sends another kind of status code, Paddle automatically retries using an exponential backoff schedule.
If your server doesn’t respond, Paddle retries after an hour.
Allow Paddle IPs
Section titled “Allow Paddle IPs”To make sure that you receive events from Paddle, we recommend that you add Paddle webhook IP addresses to your allowlist.
34.232.58.1334.195.105.13634.237.3.24435.155.119.13552.11.166.25234.212.5.734.194.127.4654.234.237.1083.208.120.14544.226.236.21044.241.183.62100.20.172.113Paddle only sends webhook events from these IP addresses.
Section titled “Paddle only sends webhook events from these IP addresses.”For security, only trust events that originate from Paddle webhook IP addresses.
Verify webhook signatures
Section titled “Verify webhook signatures”Use the Paddle-Signature header included with each webhook to verify that received events are genuinely sent by Paddle.