---
title: "Paddle webhook receiver"
method: POST
path: "/webhooks/paddle"
tags: ["Payment"]
---

# Paddle webhook receiver

`POST /webhooks/paddle`

## Request

- Base URL: `https://headlessoracle.com`
- URL: `https://headlessoracle.com/webhooks/paddle`
- Auth: none declared

Receives and processes Paddle events. Requires a valid Paddle-Signature header. Handles: transaction.completed (key generation + email), subscription.updated, subscription.past_due, subscription.canceled.

## Response `200`

Event received and processed

## Other responses

- `400`: Missing Paddle-Signature header
- `401`: Invalid signature

---

[API](https://skmtc.dev/headlessoracle/apis/headless-oracle.md) · [All operations](https://skmtc.dev/headlessoracle/apis/headless-oracle/llms.txt) · [OpenAPI document](https://skmtc.dev/headlessoracle/apis/headless-oracle/revisions/4e82fe332f29?raw)