# Paddle webhook events

Every event here can also reach agents as an MCP event through Hookdeck: [MCP events](https://hookdeck.com/webhooks/paddle/mcp-events).

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)

## address

### address.created

Confidence: documented · Schema: from Paddle docs (example)

Customer address is added

Identified by: event_type field in the body · Object: `address`

```json
{
  "event_id": "evt_01hv8gq3cywt48xmwh3hqec1ty",
  "event_type": "address.created",
  "occurred_at": "2024-04-12T06:42:59.102202Z",
  "notification_id": "ntf_01hv8gq3ez64ktsbv34bpqrqfp",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/address-created.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T06:42:59.102202Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/address-created.json)

### address.imported

Confidence: documented · Schema: from Paddle docs (example)

Address arrives through an import

Identified by: event_type field in the body · Object: `address`

```json
{
  "event_id": "evt_01hv8h6jzvsbbk6xmf7zdkrdkx",
  "event_type": "address.imported",
  "occurred_at": "2024-04-12T06:51:26.587790Z",
  "notification_id": "ntf_01hv8h6k23gm15hzrr2p4330pj",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/address-imported.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T06:51:26.587790Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/address-imported.json)

### address.updated

Confidence: documented · Schema: from Paddle docs (example)

Address details change

Identified by: event_type field in the body · Object: `address`

```json
{
  "event_id": "evt_01hv8gygr4t0xrb2v821t7x9vk",
  "event_type": "address.updated",
  "occurred_at": "2024-04-12T06:47:02.148531Z",
  "notification_id": "ntf_01hv8gygyqp6hyjjxmmag28m6p",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/address-updated.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T06:47:02.148531Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/address-updated.json)

## api_key

### api_key.created

Confidence: documented · Schema: from Paddle docs (example)

New API key is created

Identified by: event_type field in the body · Object: `api_key`

```json
{
  "event_id": "evt_01jkdr0rc527wcjdg1txsdxhtf",
  "event_type": "api_key.created",
  "occurred_at": "2025-03-26T06:58:38.517522Z",
  "notification_id": "ntf_01jkdr1mgbe62eqkh3p0fq8b0h",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/api-key-created.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2025-03-26T06:58:38.517522Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/api-key-created.json)

### api_key.expired

Confidence: documented · Schema: from Paddle docs (example)

API key passes its expiry date and stops working

Identified by: event_type field in the body · Object: `api_key`

```json
{
  "event_id": "evt_01jkdr0rc527wcjdg1txsdxhth",
  "event_type": "api_key.expired",
  "occurred_at": "2025-03-26T06:58:38.517522Z",
  "notification_id": "ntf_01jkdr1mgbe62eqkh3p0fq8b0k",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/api-key-expired.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2025-03-26T06:58:38.517522Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/api-key-expired.json)

### api_key.expiring

Confidence: documented · Schema: from Paddle docs (example)

API key has seven days or fewer left

Identified by: event_type field in the body · Object: `api_key`

```json
{
  "event_id": "evt_01jkdr0rc527wcjdg1txsdxhtj",
  "event_type": "api_key.expiring",
  "occurred_at": "2025-06-21T06:58:38.517522Z",
  "notification_id": "ntf_01jkdr1mgbe62eqkh3p0fq8b0m",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/api-key-expiring.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2025-06-21T06:58:38.517522Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/api-key-expiring.json)

### api_key.revoked

Confidence: documented · Schema: from Paddle docs (example)

API key is revoked

Identified by: event_type field in the body · Object: `api_key`

```json
{
  "event_id": "evt_01jkdr0rc527wcjdg1txsdxhtl",
  "event_type": "api_key.revoked",
  "occurred_at": "2025-06-24T12:58:38.746382Z",
  "notification_id": "ntf_01jkdr1mgbe62eqkh3p0fq8b0v",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/api-key-revoked.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2025-06-24T12:58:38.746382Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/api-key-revoked.json)

### api_key.updated

Confidence: documented · Schema: from Paddle docs (example)

API key details change

Identified by: event_type field in the body · Object: `api_key`

```json
{
  "event_id": "evt_01jkdr0rc527wcjdg1txsdxhtg",
  "event_type": "api_key.updated",
  "occurred_at": "2025-04-21T12:37:12.892738Z",
  "notification_id": "ntf_01jkdr1mgbe62eqkh3p0fq8b0j",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/api-key-updated.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2025-04-21T12:37:12.892738Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/api-key-updated.json)

### api_key_exposure.created

Confidence: documented · Schema: from Paddle docs (example)

Paddle finds an API key exposed publicly and revokes it

Identified by: event_type field in the body · Object: `api_key`

```json
{
  "event_id": "evt_01jkdr0rc527wcjdg1txsdxhtk",
  "event_type": "api_key_exposure.created",
  "occurred_at": "2025-08-19T12:58:38.746382Z",
  "notification_id": "ntf_01jkdr1mgbe62eqkh3p0fq8b0s",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/api-key-exposure-created.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2025-08-19T12:58:38.746382Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/api-key-exposure-created.json)

## business

### business.created

Confidence: documented · Schema: from Paddle docs (example)

Customer business record is added

Identified by: event_type field in the body · Object: `business`

```json
{
  "event_id": "evt_01hv8hkrsnhgn77dk3443p62je",
  "event_type": "business.created",
  "occurred_at": "2024-04-12T06:58:38.517522Z",
  "notification_id": "ntf_01hv8hkrvm7grqzht4jbq8neyz",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/business-created.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T06:58:38.517522Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/business-created.json)

### business.imported

Confidence: documented · Schema: from Paddle docs (example)

Business record arrives through an import

Identified by: event_type field in the body · Object: `business`

```json
{
  "event_id": "evt_01hv8j0zfjnmns8fgbxyz2wsp4",
  "event_type": "business.imported",
  "occurred_at": "2024-04-12T07:05:51.346952Z",
  "notification_id": "ntf_01hv8j0zhn3zcmz0vcvcmk8hmr",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/business-imported.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T07:05:51.346952Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/business-imported.json)

### business.updated

Confidence: documented · Schema: from Paddle docs (example)

Business details change

Identified by: event_type field in the body · Object: `business`

```json
{
  "event_id": "evt_01hv8hr6nwtrnt3gwrz3apjfzh",
  "event_type": "business.updated",
  "occurred_at": "2024-04-12T07:01:03.805047Z",
  "notification_id": "ntf_01hv8hr6r2vcfjtjjsqv7t5179",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/business-updated.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T07:01:03.805047Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/business-updated.json)

## client_token

### client_token.created

Confidence: documented · Schema: from Paddle docs (example)

New client-side token is created

Identified by: event_type field in the body · Object: `client_token`

```json
{
  "event_id": "evt_01jkdr0rc527wcjdg1txsdxhtf",
  "event_type": "client_token.created",
  "occurred_at": "2025-06-26T14:36:14.695521Z",
  "notification_id": "ntf_01jkdr1mgbe62eqkh3p0fq8b0h",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/client-token-created.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2025-06-26T14:36:14.695521Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/client-token-created.json)

### client_token.revoked

Confidence: documented · Schema: from Paddle docs (example)

Client-side token is revoked and stops working with Paddle.js

Identified by: event_type field in the body · Object: `client_token`

```json
{
  "event_id": "evt_01jkdr0rc527wcjdg1txsdxhtf",
  "event_type": "client_token.revoked",
  "occurred_at": "2025-06-27T11:26:10.253482Z",
  "notification_id": "ntf_01jkb92mpl7v4rfg8x3q5wz7bn",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/client-token-revoked.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2025-06-27T11:26:10.253482Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/client-token-revoked.json)

### client_token.updated

Confidence: documented · Schema: from Paddle docs (example)

Client-side token details change

Identified by: event_type field in the body · Object: `client_token`

```json
{
  "event_id": "evt_01jkdr0rc527wcjdg1txsdxhtf",
  "event_type": "client_token.updated",
  "occurred_at": "2025-06-27T11:26:10.253482Z",
  "notification_id": "ntf_01jkr4d5s6f7g8h9j1k2l3q4rs",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/client-token-updated.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2025-06-27T11:26:10.253482Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/client-token-updated.json)

## customer

### customer.created

Confidence: documented · Schema: from Paddle docs (example)

New customer is created

Identified by: event_type field in the body · Object: `customer`

```json
{
  "event_id": "evt_01hv6y1jtn1fr98zq3cvarxx2e",
  "event_type": "customer.created",
  "occurred_at": "2024-04-11T15:57:25.205966Z",
  "notification_id": "ntf_01hv6y1jx2m6n1qk95m0cj69dg",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/customer-created.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-11T15:57:25.205966Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/customer-created.json)

### customer.imported

Confidence: documented · Schema: from Paddle docs (example)

Customer arrives through an import

Identified by: event_type field in the body · Object: `customer`

```json
{
  "event_id": "evt_01hv6ymvpf2r40gjas86q60bah",
  "event_type": "customer.imported",
  "occurred_at": "2024-04-11T16:07:56.879683Z",
  "notification_id": "ntf_01hv6ymvrgdcdkv3jx4x0h2qsv",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/customer-imported.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-11T16:07:56.879683Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/customer-imported.json)

### customer.updated

Confidence: documented · Schema: from Paddle docs (example)

Customer details change

Identified by: event_type field in the body · Object: `customer`

```json
{
  "event_id": "evt_01hv6y672w8rvq8zgcq3cm3nv0",
  "event_type": "customer.updated",
  "occurred_at": "2024-04-11T15:59:57.020285Z",
  "notification_id": "ntf_01hv6y674wys2vjt7ztv4tzskj",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/customer-updated.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-11T15:59:57.020285Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/customer-updated.json)

## discount

### discount.created

Confidence: documented · Schema: from Paddle docs (example)

New discount is created

Identified by: event_type field in the body · Object: `discount`

```json
{
  "event_id": "evt_01hv6scz1kqjp8wx6ft1mc3kd2",
  "event_type": "discount.created",
  "occurred_at": "2024-04-11T14:36:15.283806Z",
  "notification_id": "ntf_01hv6scz45nrn82tmkw4ywb71k",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/discount-created.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-11T14:36:15.283806Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/discount-created.json)

### discount.imported

Confidence: documented · Schema: from Paddle docs (example)

Discount arrives through an import

Identified by: event_type field in the body · Object: `discount`

```json
{
  "event_id": "evt_01hdnnd4x84s4r5br068y3rm6d",
  "event_type": "discount.imported",
  "occurred_at": "2025-06-12T09:35:17.929027Z",
  "notification_id": "ntf_01hdnnd505rcs80ss56rfn7qa2",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/discount-imported.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2025-06-12T09:35:17.929027Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/discount-imported.json)

### discount.updated

Confidence: documented · Schema: from Paddle docs (example)

Discount details change

Identified by: event_type field in the body · Object: `discount`

```json
{
  "event_id": "evt_01hv6spb5cxrwekm2agmr173c1",
  "event_type": "discount.updated",
  "occurred_at": "2024-04-11T14:41:22.604848Z",
  "notification_id": "ntf_01hv6spb7v0f0tfg6wa3m8rgcr",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/discount-updated.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-11T14:41:22.604848Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/discount-updated.json)

### discount_group.created

Confidence: documented · Schema: from Paddle docs (example)

New group for organizing discounts is created

Identified by: event_type field in the body · Object: `discount`

```json
{
  "event_id": "evt_01hv6scz1kqjp8wx6ft1mc3kd2",
  "event_type": "discount_group.created",
  "occurred_at": "2024-11-28T14:36:15.283806Z",
  "notification_id": "ntf_01hv6scz45nrn82tmkw4ywb71k",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/discount-group-created.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-11-28T14:36:15.283806Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/discount-group-created.json)

### discount_group.updated

Confidence: documented · Schema: from Paddle docs (example)

Discount group's name or status changes

Identified by: event_type field in the body · Object: `discount`

```json
{
  "event_id": "evt_01hv6scz1kqjp8wx6ft1mc3kd2",
  "event_type": "discount_group.updated",
  "occurred_at": "2024-11-28T14:36:15.283806Z",
  "notification_id": "ntf_01hv6scz45nrn82tmkw4ywb71k",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/discount-group-updated.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-11-28T14:36:15.283806Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/discount-group-updated.json)

## price

### price.created

Confidence: documented · Schema: from Paddle docs (example)

New price is created

Identified by: event_type field in the body · Object: `price`

```json
{
  "event_id": "evt_01hv0vaxeypbdcfw039a3gmc78",
  "event_type": "price.created",
  "occurred_at": "2024-04-09T07:14:38.686498Z",
  "notification_id": "ntf_01hv0vaxj3znpd9vdpp3efa4n4",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/price-created.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-09T07:14:38.686498Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/price-created.json)

### price.imported

Confidence: documented · Schema: from Paddle docs (example)

Price arrives through an import

Identified by: event_type field in the body · Object: `price`

```json
{
  "event_id": "evt_01hgarz844zdfws6djn9rz6qm7",
  "event_type": "price.imported",
  "occurred_at": "2024-01-01T13:31:34.071379Z",
  "notification_id": "ntf_01hd46rrqkrbndwzrarcew6t21",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/price-imported.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-01-01T13:31:34.071379Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/price-imported.json)

### price.updated

Confidence: documented · Schema: from Paddle docs (example)

Price details change

Identified by: event_type field in the body · Object: `price`

```json
{
  "event_id": "evt_01hv0vd770td3m64srybj8453a",
  "event_type": "price.updated",
  "occurred_at": "2024-04-09T07:15:54.208116Z",
  "notification_id": "ntf_01hv0vd7900qdtv6h6w8m2h6qf",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/price-updated.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-09T07:15:54.208116Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/price-updated.json)

## product

### product.created

Confidence: documented · Schema: from Paddle docs (example)

New product is created

Identified by: event_type field in the body · Object: `product`

```json
{
  "event_id": "evt_01htz88y5k59y9rrv15p72dv91",
  "event_type": "product.created",
  "occurred_at": "2024-04-08T16:22:16.499189Z",
  "notification_id": "ntf_01htz88y8sg8cww5jdj4q68yq0",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/product-created.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-08T16:22:16.499189Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/product-created.json)

### product.imported

Confidence: documented · Schema: from Paddle docs (example)

Product arrives through an import

Identified by: event_type field in the body · Object: `product`

```json
{
  "event_id": "evt_01hgas2cm8r02nxryp83jqvg6k",
  "event_type": "product.imported",
  "occurred_at": "2024-01-28T10:54:46.181Z",
  "notification_id": "ntf_01hd46rqryfc8d7d5yz595k2k6",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/product-imported.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-01-28T10:54:46.181Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/product-imported.json)

### product.updated

Confidence: documented · Schema: from Paddle docs (example)

Product details change

Identified by: event_type field in the body · Object: `product`

```json
{
  "event_id": "evt_01htz8kd4g9npcy0c76y5pvrs5",
  "event_type": "product.updated",
  "occurred_at": "2024-04-08T16:27:59.504385Z",
  "notification_id": "ntf_01htz8kd6sysr4sqefs5a9qqc0",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/product-updated.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-08T16:27:59.504385Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/product-updated.json)

## subscription

### subscription.activated

Confidence: documented · Schema: from Paddle docs (example)

Subscription turns active after any trial and a successful bill

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "event_id": "evt_01hv8x2adt2hy58b2w89p4py4d",
  "event_type": "subscription.activated",
  "occurred_at": "2024-04-12T10:18:49.658605Z",
  "notification_id": "ntf_01hv8x2ag2hadnwngnf1qvegrp",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/subscription-activated.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T10:18:49.658605Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/subscription-activated.json)

### subscription.canceled

Confidence: documented · Schema: from Paddle docs (example)

Subscription moves to canceled

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "event_id": "evt_01hv90vbenb5d4spnjbbcfh3nk",
  "event_type": "subscription.canceled",
  "occurred_at": "2024-04-12T11:24:55.637846Z",
  "notification_id": "ntf_01hv90vbk0t9skkjqazdq3emtz",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/subscription-canceled.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T11:24:55.637846Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/subscription-canceled.json)

### subscription.created

Confidence: documented · Schema: from Paddle docs (example)

New subscription is created

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "event_id": "evt_01hv8x2acma2gz7he8kg2s0hna",
  "event_type": "subscription.created",
  "occurred_at": "2024-04-12T10:18:49.621022Z",
  "notification_id": "ntf_01hv8x2af22vrrz7k67g06x1kq",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/subscription-created.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T10:18:49.621022Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/subscription-created.json)

### subscription.imported

Confidence: documented · Schema: from Paddle docs (example)

Subscription arrives through an import

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "event_id": "evt_01hv90ze5sg2gcazvqmqjwzcnf",
  "event_type": "subscription.imported",
  "occurred_at": "2024-04-12T11:27:09.497701Z",
  "notification_id": "ntf_01hv90ze96bnqq3smhha1t9f4e",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/subscription-imported.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T11:27:09.497701Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/subscription-imported.json)

### subscription.past_due

Confidence: documented · Schema: from Paddle docs (example)

Subscription has an unpaid transaction

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "event_id": "evt_01hv8xby85a4vxfhgx493xvhjd",
  "event_type": "subscription.past_due",
  "occurred_at": "2024-05-12T10:19:26.014628Z",
  "notification_id": "ntf_01hv8xbycgekeyat76j9ah2k3d",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/subscription-past-due.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-05-12T10:19:26.014628Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/subscription-past-due.json)

### subscription.paused

Confidence: documented · Schema: from Paddle docs (example)

Subscription moves to paused

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "event_id": "evt_01hv95bn2k322d8y74ks0ppgmk",
  "event_type": "subscription.paused",
  "occurred_at": "2024-04-12T12:43:44.083397Z",
  "notification_id": "ntf_01hv95bn52k92r8je00te7wfke",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/subscription-paused.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T12:43:44.083397Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/subscription-paused.json)

### subscription.resumed

Confidence: documented · Schema: from Paddle docs (example)

Paused subscription turns active and is billed again

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "event_id": "evt_01hv95drrfx0yapgmnv0x59kk7",
  "event_type": "subscription.resumed",
  "occurred_at": "2024-04-12T12:44:53.391712Z",
  "notification_id": "ntf_01hv95drvs9bfmbtfgkrwsjgwa",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/subscription-resumed.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T12:44:53.391712Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/subscription-resumed.json)

### subscription.trialing

Confidence: documented · Schema: from Paddle docs (example)

Subscription starts a trial period

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "event_id": "evt_01hv915jfwxvzkq35bfnpxs9ck",
  "event_type": "subscription.trialing",
  "occurred_at": "2024-04-12T11:30:30.524449Z",
  "notification_id": "ntf_01hv915jjxeqf1t0wrbqzkjh6g",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/subscription-trialing.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T11:30:30.524449Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/subscription-trialing.json)

### subscription.updated

Confidence: documented · Schema: from Paddle docs (example)

Subscription changes, including items, billing details and scheduled changes

Identified by: event_type field in the body · Object: `subscription`

```json
{
  "event_id": "evt_01hv8ytwcg91n07pa4jmvsdcst",
  "event_type": "subscription.updated",
  "occurred_at": "2024-04-12T10:49:43.056742Z",
  "notification_id": "ntf_01hv8ytwevhn1sdtwzhf4rz548",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/subscription-updated.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T10:49:43.056742Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/subscription-updated.json)

## transaction

### transaction.billed

Confidence: documented · Schema: from Paddle docs (example)

Transaction is marked billed, typically for an invoice

Identified by: event_type field in the body · Object: `transaction`

```json
{
  "event_id": "evt_01hv8xqmb9e8y66q4hb54cfsf9",
  "event_type": "transaction.billed",
  "occurred_at": "2024-04-12T10:30:27.945096Z",
  "notification_id": "ntf_01hv8xqmdrrnsp7rvaf1264cp2",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/transaction-billed.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T10:30:27.945096Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/transaction-billed.json)

### transaction.canceled

Confidence: documented · Schema: from Paddle docs (example)

Transaction is canceled, typically an invoice raised in error

Identified by: event_type field in the body · Object: `transaction`

```json
{
  "event_id": "evt_01hv8xsew895m2bswfcezebbjw",
  "event_type": "transaction.canceled",
  "occurred_at": "2024-04-12T10:31:27.880764Z",
  "notification_id": "ntf_01hv8xseze1cnv8k83cnhtn4zr",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/transaction-canceled.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T10:31:27.880764Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/transaction-canceled.json)

### transaction.completed

Confidence: documented · Schema: from Paddle docs (example)

Paddle finishes processing a paid transaction

Identified by: event_type field in the body · Object: `transaction`

```json
{
  "event_id": "evt_01hv8x2axb33yr5y238zfwcn5p",
  "event_type": "transaction.completed",
  "occurred_at": "2024-04-12T10:18:50.155553Z",
  "notification_id": "ntf_01hv8x2azy7scaan4s0eb0273x",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/transaction-completed.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T10:18:50.155553Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/transaction-completed.json)

### transaction.created

Confidence: documented · Schema: from Paddle docs (example)

New transaction is created, for example when checkout opens

Identified by: event_type field in the body · Object: `transaction`

```json
{
  "event_id": "evt_01hv8wpv7nkct05j2zxxvpz6dm",
  "event_type": "transaction.created",
  "occurred_at": "2024-04-12T10:12:33.653418Z",
  "notification_id": "ntf_01hv8wpva216nz1ykxf3m3vwyr",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/transaction-created.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T10:12:33.653418Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/transaction-created.json)

### transaction.paid

Confidence: documented · Schema: from Paddle docs (example)

Payment is captured, before Paddle finishes processing

Identified by: event_type field in the body · Object: `transaction`

```json
{
  "event_id": "evt_01hv8x29mtm3f42a00bp5v8va9",
  "event_type": "transaction.paid",
  "occurred_at": "2024-04-12T10:18:48.858999Z",
  "notification_id": "ntf_01hv8x29q0j8ttnj51q5024qfp",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/transaction-paid.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T10:18:48.858999Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/transaction-paid.json)

### transaction.past_due

Confidence: documented · Schema: from Paddle docs (example)

Transaction payment is overdue or a renewal attempt failed

Identified by: event_type field in the body · Object: `transaction`

```json
{
  "event_id": "evt_01hv8xbx1sxvjqpp24m7j3xthf",
  "event_type": "transaction.past_due",
  "occurred_at": "2024-04-12T10:24:03.642083Z",
  "notification_id": "ntf_01hv8xbx5rj101psexq5wndwd3",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/transaction-past-due.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T10:24:03.642083Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/transaction-past-due.json)

### transaction.payment_failed

Confidence: documented · Schema: from Paddle docs (example)

Payment attempt fails

Identified by: event_type field in the body · Object: `transaction`

```json
{
  "event_id": "evt_01hv8wx4vr9w6zsv6xss0b8az9",
  "event_type": "transaction.payment_failed",
  "occurred_at": "2024-04-12T10:16:00.120972Z",
  "notification_id": "ntf_01hv8wx4ywcj8pptnpeq1rrvzm",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/transaction-payment-failed.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T10:16:00.120972Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/transaction-payment-failed.json)

### transaction.ready

Confidence: documented · Schema: from Paddle docs (example)

Transaction has the fields it needs to be billed

Identified by: event_type field in the body · Object: `transaction`

```json
{
  "event_id": "evt_01hv8wt9q80exvgq58y668kszj",
  "event_type": "transaction.ready",
  "occurred_at": "2024-04-12T10:14:26.792582Z",
  "notification_id": "ntf_01hv8wt9sx34v7vmjffpbt4dbt",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/transaction-ready.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T10:14:26.792582Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/transaction-ready.json)

### transaction.revised

Confidence: documented · Schema: from Paddle docs (example)

Customer details change on a billed or completed transaction

Identified by: event_type field in the body · Object: `transaction`

```json
{
  "event_id": "evt_01hzpwdkc41q67tbawb73h0t7p",
  "event_type": "transaction.revised",
  "occurred_at": "2024-06-06T13:39:40.036493Z",
  "notification_id": "ntf_01hzpwdkj9akeqyv4padq7ndwc",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/transaction-revised.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-06-06T13:39:40.036493Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/transaction-revised.json)

### transaction.updated

Confidence: documented · Schema: from Paddle docs (example)

Transaction changes, often adding fields after a status event

Identified by: event_type field in the body · Object: `transaction`

```json
{
  "event_id": "evt_01hv8vzzb6rhnvxtf571ddsfgs",
  "event_type": "transaction.updated",
  "occurred_at": "2024-04-12T10:00:04.198351Z",
  "notification_id": "ntf_01hv8vzzejmbstvpmpa2qf7sct",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/transaction-updated.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-12T10:00:04.198351Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/transaction-updated.json)

## Other Paddle events

### adjustment.created

Confidence: documented · Schema: from Paddle docs (example)

Refund or credit is raised against a transaction

Identified by: event_type field in the body · Object: `adjustment`

```json
{
  "event_id": "evt_01hvgf2skkg8dsk5dczemw2bx1",
  "event_type": "adjustment.created",
  "occurred_at": "2024-04-15T08:48:20.595926Z",
  "notification_id": "ntf_01hvgf2spk3bvewnw8t2zrnbmb",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/adjustment-created.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-15T08:48:20.595926Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/adjustment-created.json)

### adjustment.updated

Confidence: documented · Schema: from Paddle docs (example)

Paddle approves or rejects a refund that needed review

Identified by: event_type field in the body · Object: `adjustment`

```json
{
  "event_id": "evt_01hvgfdfepj8eaevsjh5g4swbe",
  "event_type": "adjustment.updated",
  "occurred_at": "2024-04-15T08:54:10.646377Z",
  "notification_id": "ntf_01hvgfdfhwncqrrjz1nz5eky9a",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/adjustment-updated.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-15T08:54:10.646377Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/adjustment-updated.json)

### meter.created

Confidence: documented · Schema: from Paddle docs (example)

New usage meter is created (usage billing beta)

Identified by: event_type field in the body · Object: `meter`

```json
{
  "event_id": "evt_01kw8tj8fq5rp3n7m0h9d4vsb2",
  "event_type": "meter.created",
  "occurred_at": "2026-09-01T09:10:00.283806Z",
  "notification_id": "ntf_01kw8tj9k7v2ah6y8pxr3q1nfe",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/meter-created.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2026-09-01T09:10:00.283806Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/meter-created.json)

### meter.updated

Confidence: documented · Schema: from Paddle docs (example)

Usage meter changes or is archived (usage billing beta)

Identified by: event_type field in the body · Object: `meter`

```json
{
  "event_id": "evt_01kw8vh2m5r7wq4s9t6xka2vjy",
  "event_type": "meter.updated",
  "occurred_at": "2026-09-10T12:03:41.823806Z",
  "notification_id": "ntf_01kw8vh38b1zpm2v7q4rd0xnaf",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/meter-updated.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2026-09-10T12:03:41.823806Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/meter-updated.json)

### payment_method.deleted

Confidence: documented · Schema: from Paddle docs (example)

Saved payment method is removed or replaced

Identified by: event_type field in the body · Object: `payment_method`

```json
{
  "event_id": "evt_01hwz6k64a210xcvsdbg3y4vmr",
  "event_type": "payment_method.deleted",
  "occurred_at": "2024-05-03T12:24:18.826338Z",
  "notification_id": "ntf_01hwz6k66fp6cxtxyt6551wv7z",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/payment-method-deleted.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-05-03T12:24:18.826338Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/payment-method-deleted.json)

### payment_method.saved

Confidence: documented · Schema: from Paddle docs (example)

Payment method is stored for a customer

Identified by: event_type field in the body · Object: `payment_method`

```json
{
  "event_id": "evt_01hwvkmsge7bhq1a31s35784zt",
  "event_type": "payment_method.saved",
  "occurred_at": "2024-05-02T02:55:25.198953Z",
  "notification_id": "ntf_01hwvkmsknrgqw4z1598qw4ypt",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/payment-method-saved.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-05-02T02:55:25.198953Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/payment-method-saved.json)

### payout.created

Confidence: documented · Schema: from Paddle docs (example)

Paddle starts a payout to you

Identified by: event_type field in the body · Object: `payout`

```json
{
  "event_id": "evt_01h2b06f69w9aw3eymqs1dfa2q",
  "event_type": "payout.created",
  "occurred_at": "2023-06-01T13:30:38.138984Z",
  "notification_id": "ntf_01h2b06f84qsjzdw8rywe3j4gt",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/payout-created.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2023-06-01T13:30:38.138984Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/payout-created.json)

### payout.paid

Confidence: documented · Schema: from Paddle docs (example)

Payout is paid out, usually a working day before funds land

Identified by: event_type field in the body · Object: `payout`

```json
{
  "event_id": "evt_01h2b0tqg1xkgnkfmprsnrjn0s",
  "event_type": "payout.paid",
  "occurred_at": "2023-06-07T13:30:38.138984Z",
  "notification_id": "ntf_01h2b0tqkhfqd094y9pys30xyw",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/payout-paid.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2023-06-07T13:30:38.138984Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/payout-paid.json)

### report.created

Confidence: documented · Schema: from Paddle docs (example)

Report is requested and starts generating

Identified by: event_type field in the body · Object: `report`

```json
{
  "event_id": "evt_01hvgdpb99hxbjje8npcvk3za0",
  "event_type": "report.created",
  "occurred_at": "2024-04-15T08:24:04.137829Z",
  "notification_id": "ntf_01hvgdpbc5rqqxh6j1daqs7n3x",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/report-created.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-15T08:24:04.137829Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/report-created.json)

### report.updated

Confidence: documented · Schema: from Paddle docs (example)

Report finishes generating and is ready to download

Identified by: event_type field in the body · Object: `report`

```json
{
  "event_id": "evt_01hvgdpmap3espxga4jwzb0agp",
  "event_type": "report.updated",
  "occurred_at": "2024-04-15T08:24:13.398892Z",
  "notification_id": "ntf_01hvgdpmd2g0dv4vpmys3z7bc3",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/report-updated.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2024-04-15T08:24:13.398892Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/report-updated.json)

### usage_balance.depleted

Confidence: documented · Schema: from Paddle docs (example)

Customer's usage balance reaches zero (usage billing beta)

Identified by: event_type field in the body · Object: `usage_balance`

```json
{
  "event_id": "evt_01js2n02s4fr6a8gvfm5enq0as",
  "event_type": "usage_balance.depleted",
  "occurred_at": "2026-09-27T16:42:10.283806Z",
  "notification_id": "ntf_01js2n03f91aw3v7q6f7x55r3z",
  "data": { … }
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/paddle/events/usage-balance-depleted.json)

| Key field | Type | Example |
|---|---|---|
| `occurred_at` | string | `2026-09-27T16:42:10.283806Z` |

From Paddle docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/paddle/events/usage-balance-depleted.json)

---

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)
