Sign in

v1

latestOpenAPI 3.1.02026-08-045217107.2 KB
Webhooks

Paddle Webhook

Receives Paddle billing events (subscription created/updated/canceled, payment completed/failed). Validates the Paddle-Signature header using HMAC-SHA256. This endpoint is for Paddle servers only — not for direct API consumers.

post/webhooks/paddle

Headers

Paddle-Signaturestring required

HMAC-SHA256 signature: ts=<timestamp>;h1=<hash>

Request body

event_idstring
event_type'subscription.created' | 'subscription.activated' | 'subscription.updated' | 'subscription.canceled' | 'subscription.paused' | 'subscription.resumed' | 'subscription.past_due' | 'transaction.completed' | 'transaction.payment_failed'
occurred_atstring date-time
notification_idstring
dataobject

Response

Webhook received