# Paddle MCP events

Paddle's webhook events are available to agents as MCP events through Hookdeck Event Gateway.

These pages cover Paddle Billing, which everyone who signed up after 8 August 2023 has. Paddle Classic is a separate legacy product that verifies webhooks differently, with [a `p_signature` body field and a public key](https://classic.paddle.com/webhooks/verifying-webhooks/).

Agent skill: `npx skills add hookdeck/webhook-skills --skill paddle-webhooks` ([details](https://hookdeck.com/webhooks/paddle/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Paddle's official docs](https://developer.paddle.com/webhooks/about/how-webhooks-work/).

[Overview](https://hookdeck.com/webhooks/paddle) · [Webhook events (59)](https://hookdeck.com/webhooks/paddle/events) · [MCP events](https://hookdeck.com/webhooks/paddle/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/paddle/verify) · [Production guide](https://hookdeck.com/webhooks/paddle/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/paddle/skill)

## Paddle's MCP server

Paddle's MCP server (`mcp.paddle.com/mcp`, or `sandbox-mcp.paddle.com/mcp` for sandbox) lets agents read data and take actions in your Paddle account, including configuring webhooks and simulating events. Those tools call Paddle; they don't deliver Paddle's events. To get Paddle's events into an agent, subscribe it through Hookdeck Event Gateway, as described below. [Paddle's MCP docs](https://developer.paddle.com/sdks/ai/paddle-mcp)

## How to subscribe

1. Connect your agent to Hookdeck's MCP server ([MCP Events bridge](https://hookdeck.com/blog/mcp-events-bridge)).
2. Point your Paddle webhook at a Hookdeck source.
3. Your agent lists the available events and subscribes to the ones it needs.

## Events

| Webhook event | MCP event |
|---|---|
| [address.created](https://hookdeck.com/webhooks/paddle/events#address.created) | `paddle.address.created` |
| [address.imported](https://hookdeck.com/webhooks/paddle/events#address.imported) | `paddle.address.imported` |
| [address.updated](https://hookdeck.com/webhooks/paddle/events#address.updated) | `paddle.address.updated` |
| [adjustment.created](https://hookdeck.com/webhooks/paddle/events#adjustment.created) | `paddle.adjustment.created` |
| [adjustment.updated](https://hookdeck.com/webhooks/paddle/events#adjustment.updated) | `paddle.adjustment.updated` |
| [api_key.created](https://hookdeck.com/webhooks/paddle/events#api_key.created) | `paddle.api_key.created` |
| [api_key.expired](https://hookdeck.com/webhooks/paddle/events#api_key.expired) | `paddle.api_key.expired` |
| [api_key.expiring](https://hookdeck.com/webhooks/paddle/events#api_key.expiring) | `paddle.api_key.expiring` |
| [api_key.revoked](https://hookdeck.com/webhooks/paddle/events#api_key.revoked) | `paddle.api_key.revoked` |
| [api_key.updated](https://hookdeck.com/webhooks/paddle/events#api_key.updated) | `paddle.api_key.updated` |
| [api_key_exposure.created](https://hookdeck.com/webhooks/paddle/events#api_key_exposure.created) | `paddle.api_key_exposure.created` |
| [business.created](https://hookdeck.com/webhooks/paddle/events#business.created) | `paddle.business.created` |
| [business.imported](https://hookdeck.com/webhooks/paddle/events#business.imported) | `paddle.business.imported` |
| [business.updated](https://hookdeck.com/webhooks/paddle/events#business.updated) | `paddle.business.updated` |
| [client_token.created](https://hookdeck.com/webhooks/paddle/events#client_token.created) | `paddle.client_token.created` |
| [client_token.revoked](https://hookdeck.com/webhooks/paddle/events#client_token.revoked) | `paddle.client_token.revoked` |
| [client_token.updated](https://hookdeck.com/webhooks/paddle/events#client_token.updated) | `paddle.client_token.updated` |
| [customer.created](https://hookdeck.com/webhooks/paddle/events#customer.created) | `paddle.customer.created` |
| [customer.imported](https://hookdeck.com/webhooks/paddle/events#customer.imported) | `paddle.customer.imported` |
| [customer.updated](https://hookdeck.com/webhooks/paddle/events#customer.updated) | `paddle.customer.updated` |
| [discount.created](https://hookdeck.com/webhooks/paddle/events#discount.created) | `paddle.discount.created` |
| [discount.imported](https://hookdeck.com/webhooks/paddle/events#discount.imported) | `paddle.discount.imported` |
| [discount.updated](https://hookdeck.com/webhooks/paddle/events#discount.updated) | `paddle.discount.updated` |
| [discount_group.created](https://hookdeck.com/webhooks/paddle/events#discount_group.created) | `paddle.discount_group.created` |
| [discount_group.updated](https://hookdeck.com/webhooks/paddle/events#discount_group.updated) | `paddle.discount_group.updated` |
| [meter.created](https://hookdeck.com/webhooks/paddle/events#meter.created) | `paddle.meter.created` |
| [meter.updated](https://hookdeck.com/webhooks/paddle/events#meter.updated) | `paddle.meter.updated` |
| [payment_method.deleted](https://hookdeck.com/webhooks/paddle/events#payment_method.deleted) | `paddle.payment_method.deleted` |
| [payment_method.saved](https://hookdeck.com/webhooks/paddle/events#payment_method.saved) | `paddle.payment_method.saved` |
| [payout.created](https://hookdeck.com/webhooks/paddle/events#payout.created) | `paddle.payout.created` |
| [payout.paid](https://hookdeck.com/webhooks/paddle/events#payout.paid) | `paddle.payout.paid` |
| [price.created](https://hookdeck.com/webhooks/paddle/events#price.created) | `paddle.price.created` |
| [price.imported](https://hookdeck.com/webhooks/paddle/events#price.imported) | `paddle.price.imported` |
| [price.updated](https://hookdeck.com/webhooks/paddle/events#price.updated) | `paddle.price.updated` |
| [product.created](https://hookdeck.com/webhooks/paddle/events#product.created) | `paddle.product.created` |
| [product.imported](https://hookdeck.com/webhooks/paddle/events#product.imported) | `paddle.product.imported` |
| [product.updated](https://hookdeck.com/webhooks/paddle/events#product.updated) | `paddle.product.updated` |
| [report.created](https://hookdeck.com/webhooks/paddle/events#report.created) | `paddle.report.created` |
| [report.updated](https://hookdeck.com/webhooks/paddle/events#report.updated) | `paddle.report.updated` |
| [subscription.activated](https://hookdeck.com/webhooks/paddle/events#subscription.activated) | `paddle.subscription.activated` |
| [subscription.canceled](https://hookdeck.com/webhooks/paddle/events#subscription.canceled) | `paddle.subscription.canceled` |
| [subscription.created](https://hookdeck.com/webhooks/paddle/events#subscription.created) | `paddle.subscription.created` |
| [subscription.imported](https://hookdeck.com/webhooks/paddle/events#subscription.imported) | `paddle.subscription.imported` |
| [subscription.past_due](https://hookdeck.com/webhooks/paddle/events#subscription.past_due) | `paddle.subscription.past_due` |
| [subscription.paused](https://hookdeck.com/webhooks/paddle/events#subscription.paused) | `paddle.subscription.paused` |
| [subscription.resumed](https://hookdeck.com/webhooks/paddle/events#subscription.resumed) | `paddle.subscription.resumed` |
| [subscription.trialing](https://hookdeck.com/webhooks/paddle/events#subscription.trialing) | `paddle.subscription.trialing` |
| [subscription.updated](https://hookdeck.com/webhooks/paddle/events#subscription.updated) | `paddle.subscription.updated` |
| [transaction.billed](https://hookdeck.com/webhooks/paddle/events#transaction.billed) | `paddle.transaction.billed` |
| [transaction.canceled](https://hookdeck.com/webhooks/paddle/events#transaction.canceled) | `paddle.transaction.canceled` |
| [transaction.completed](https://hookdeck.com/webhooks/paddle/events#transaction.completed) | `paddle.transaction.completed` |
| [transaction.created](https://hookdeck.com/webhooks/paddle/events#transaction.created) | `paddle.transaction.created` |
| [transaction.paid](https://hookdeck.com/webhooks/paddle/events#transaction.paid) | `paddle.transaction.paid` |
| [transaction.past_due](https://hookdeck.com/webhooks/paddle/events#transaction.past_due) | `paddle.transaction.past_due` |
| [transaction.payment_failed](https://hookdeck.com/webhooks/paddle/events#transaction.payment_failed) | `paddle.transaction.payment_failed` |
| [transaction.ready](https://hookdeck.com/webhooks/paddle/events#transaction.ready) | `paddle.transaction.ready` |
| [transaction.revised](https://hookdeck.com/webhooks/paddle/events#transaction.revised) | `paddle.transaction.revised` |
| [transaction.updated](https://hookdeck.com/webhooks/paddle/events#transaction.updated) | `paddle.transaction.updated` |
| [usage_balance.depleted](https://hookdeck.com/webhooks/paddle/events#usage_balance.depleted) | `paddle.usage_balance.depleted` |
---

Not affiliated with Paddle. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/paddle.json) · [Report a correction](https://hookdeck.com/contact)
