Paddle webhook events
59 Paddle event types in 10 resources, plus Other Paddle events. 59 have sample payloads.
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.
Every event here can also reach agents as an MCP event through Hookdeck: MCP events →
address
address.created
documented from Paddle docs (example)
address.created Customer address is added
Identified by event_type field in the body
Resource address
{
"event_id": "evt_01hv8gq3cywt48xmwh3hqec1ty",
"event_type": "address.created",
"occurred_at": "2024-04-12T06:42:59.102202Z",
"notification_id": "ntf_01hv8gq3ez64ktsbv34bpqrqfp",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T06:42:59.102202Z |
Full schema: 19 fields.
From Paddle docs
-
Content type
application/json
address.imported
documented from Paddle docs (example)
address.imported Address arrives through an import
Identified by event_type field in the body
Resource address
{
"event_id": "evt_01hv8h6jzvsbbk6xmf7zdkrdkx",
"event_type": "address.imported",
"occurred_at": "2024-04-12T06:51:26.587790Z",
"notification_id": "ntf_01hv8h6k23gm15hzrr2p4330pj",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T06:51:26.587790Z |
Full schema: 21 fields.
From Paddle docs
-
Content type
application/json
address.updated
documented from Paddle docs (example)
address.updated Address details change
Identified by event_type field in the body
Resource address
{
"event_id": "evt_01hv8gygr4t0xrb2v821t7x9vk",
"event_type": "address.updated",
"occurred_at": "2024-04-12T06:47:02.148531Z",
"notification_id": "ntf_01hv8gygyqp6hyjjxmmag28m6p",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T06:47:02.148531Z |
Full schema: 20 fields.
From Paddle docs
-
Content type
application/json
api_key
api_key.created
documented from Paddle docs (example)
api_key.created New API key is created
Identified by event_type field in the body
Resource api_key
{
"event_id": "evt_01jkdr0rc527wcjdg1txsdxhtf",
"event_type": "api_key.created",
"occurred_at": "2025-03-26T06:58:38.517522Z",
"notification_id": "ntf_01jkdr1mgbe62eqkh3p0fq8b0h",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2025-03-26T06:58:38.517522Z |
Full schema: 18 fields.
From Paddle docs
-
Content type
application/json
api_key.expired
documented from Paddle docs (example)
api_key.expired API key passes its expiry date and stops working
Identified by event_type field in the body
Resource api_key
{
"event_id": "evt_01jkdr0rc527wcjdg1txsdxhth",
"event_type": "api_key.expired",
"occurred_at": "2025-03-26T06:58:38.517522Z",
"notification_id": "ntf_01jkdr1mgbe62eqkh3p0fq8b0k",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2025-03-26T06:58:38.517522Z |
Full schema: 18 fields.
From Paddle docs
-
Content type
application/json
api_key.expiring
documented from Paddle docs (example)
api_key.expiring API key has seven days or fewer left
Identified by event_type field in the body
Resource api_key
{
"event_id": "evt_01jkdr0rc527wcjdg1txsdxhtj",
"event_type": "api_key.expiring",
"occurred_at": "2025-06-21T06:58:38.517522Z",
"notification_id": "ntf_01jkdr1mgbe62eqkh3p0fq8b0m",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2025-06-21T06:58:38.517522Z |
Full schema: 18 fields.
From Paddle docs
-
Content type
application/json
api_key.revoked
documented from Paddle docs (example)
api_key.revoked API key is revoked
Identified by event_type field in the body
Resource api_key
{
"event_id": "evt_01jkdr0rc527wcjdg1txsdxhtl",
"event_type": "api_key.revoked",
"occurred_at": "2025-06-24T12:58:38.746382Z",
"notification_id": "ntf_01jkdr1mgbe62eqkh3p0fq8b0v",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2025-06-24T12:58:38.746382Z |
Full schema: 18 fields.
From Paddle docs
-
Content type
application/json
api_key.updated
documented from Paddle docs (example)
api_key.updated API key details change
Identified by event_type field in the body
Resource api_key
{
"event_id": "evt_01jkdr0rc527wcjdg1txsdxhtg",
"event_type": "api_key.updated",
"occurred_at": "2025-04-21T12:37:12.892738Z",
"notification_id": "ntf_01jkdr1mgbe62eqkh3p0fq8b0j",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2025-04-21T12:37:12.892738Z |
Full schema: 18 fields.
From Paddle docs
-
Content type
application/json
api_key_exposure.created
documented from Paddle docs (example)
api_key_exposure.created Paddle finds an API key exposed publicly and revokes it
Identified by event_type field in the body
Resource api_key
{
"event_id": "evt_01jkdr0rc527wcjdg1txsdxhtk",
"event_type": "api_key_exposure.created",
"occurred_at": "2025-08-19T12:58:38.746382Z",
"notification_id": "ntf_01jkdr1mgbe62eqkh3p0fq8b0s",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2025-08-19T12:58:38.746382Z |
Full schema: 13 fields.
From Paddle docs
-
Content type
application/json
business
business.created
documented from Paddle docs (example)
business.created Customer business record is added
Identified by event_type field in the body
Resource business
{
"event_id": "evt_01hv8hkrsnhgn77dk3443p62je",
"event_type": "business.created",
"occurred_at": "2024-04-12T06:58:38.517522Z",
"notification_id": "ntf_01hv8hkrvm7grqzht4jbq8neyz",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T06:58:38.517522Z |
Full schema: 19 fields.
From Paddle docs
-
Content type
application/json
business.imported
documented from Paddle docs (example)
business.imported Business record arrives through an import
Identified by event_type field in the body
Resource business
{
"event_id": "evt_01hv8j0zfjnmns8fgbxyz2wsp4",
"event_type": "business.imported",
"occurred_at": "2024-04-12T07:05:51.346952Z",
"notification_id": "ntf_01hv8j0zhn3zcmz0vcvcmk8hmr",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T07:05:51.346952Z |
Full schema: 21 fields.
From Paddle docs
-
Content type
application/json
business.updated
documented from Paddle docs (example)
business.updated Business details change
Identified by event_type field in the body
Resource business
{
"event_id": "evt_01hv8hr6nwtrnt3gwrz3apjfzh",
"event_type": "business.updated",
"occurred_at": "2024-04-12T07:01:03.805047Z",
"notification_id": "ntf_01hv8hr6r2vcfjtjjsqv7t5179",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T07:01:03.805047Z |
Full schema: 20 fields.
From Paddle docs
-
Content type
application/json
client_token
client_token.created
documented from Paddle docs (example)
client_token.created New client-side token is created
Identified by event_type field in the body
Resource client_token
{
"event_id": "evt_01jkdr0rc527wcjdg1txsdxhtf",
"event_type": "client_token.created",
"occurred_at": "2025-06-26T14:36:14.695521Z",
"notification_id": "ntf_01jkdr1mgbe62eqkh3p0fq8b0h",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2025-06-26T14:36:14.695521Z |
Full schema: 13 fields.
From Paddle docs
-
Content type
application/json
client_token.revoked
documented from Paddle docs (example)
client_token.revoked Client-side token is revoked and stops working with Paddle.js
Identified by event_type field in the body
Resource client_token
{
"event_id": "evt_01jkdr0rc527wcjdg1txsdxhtf",
"event_type": "client_token.revoked",
"occurred_at": "2025-06-27T11:26:10.253482Z",
"notification_id": "ntf_01jkb92mpl7v4rfg8x3q5wz7bn",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2025-06-27T11:26:10.253482Z |
Full schema: 13 fields.
From Paddle docs
-
Content type
application/json
client_token.updated
documented from Paddle docs (example)
client_token.updated Client-side token details change
Identified by event_type field in the body
Resource client_token
{
"event_id": "evt_01jkdr0rc527wcjdg1txsdxhtf",
"event_type": "client_token.updated",
"occurred_at": "2025-06-27T11:26:10.253482Z",
"notification_id": "ntf_01jkr4d5s6f7g8h9j1k2l3q4rs",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2025-06-27T11:26:10.253482Z |
Full schema: 13 fields.
From Paddle docs
-
Content type
application/json
customer
customer.created
documented from Paddle docs (example)
customer.created New customer is created
Identified by event_type field in the body
Resource customer
{
"event_id": "evt_01hv6y1jtn1fr98zq3cvarxx2e",
"event_type": "customer.created",
"occurred_at": "2024-04-11T15:57:25.205966Z",
"notification_id": "ntf_01hv6y1jx2m6n1qk95m0cj69dg",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-11T15:57:25.205966Z |
Full schema: 15 fields.
From Paddle docs
-
Content type
application/json
customer.imported
documented from Paddle docs (example)
customer.imported Customer arrives through an import
Identified by event_type field in the body
Resource customer
{
"event_id": "evt_01hv6ymvpf2r40gjas86q60bah",
"event_type": "customer.imported",
"occurred_at": "2024-04-11T16:07:56.879683Z",
"notification_id": "ntf_01hv6ymvrgdcdkv3jx4x0h2qsv",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-11T16:07:56.879683Z |
Full schema: 17 fields.
From Paddle docs
-
Content type
application/json
customer.updated
documented from Paddle docs (example)
customer.updated Customer details change
Identified by event_type field in the body
Resource customer
{
"event_id": "evt_01hv6y672w8rvq8zgcq3cm3nv0",
"event_type": "customer.updated",
"occurred_at": "2024-04-11T15:59:57.020285Z",
"notification_id": "ntf_01hv6y674wys2vjt7ztv4tzskj",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-11T15:59:57.020285Z |
Full schema: 15 fields.
From Paddle docs
-
Content type
application/json
discount
discount.created
documented from Paddle docs (example)
discount.created New discount is created
Identified by event_type field in the body
Resource discount
{
"event_id": "evt_01hv6scz1kqjp8wx6ft1mc3kd2",
"event_type": "discount.created",
"occurred_at": "2024-04-11T14:36:15.283806Z",
"notification_id": "ntf_01hv6scz45nrn82tmkw4ywb71k",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-11T14:36:15.283806Z |
Full schema: 24 fields.
From Paddle docs
-
Content type
application/json
discount.imported
documented from Paddle docs (example)
discount.imported Discount arrives through an import
Identified by event_type field in the body
Resource discount
{
"event_id": "evt_01hdnnd4x84s4r5br068y3rm6d",
"event_type": "discount.imported",
"occurred_at": "2025-06-12T09:35:17.929027Z",
"notification_id": "ntf_01hdnnd505rcs80ss56rfn7qa2",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2025-06-12T09:35:17.929027Z |
Full schema: 27 fields.
From Paddle docs
-
Content type
application/json
discount.updated
documented from Paddle docs (example)
discount.updated Discount details change
Identified by event_type field in the body
Resource discount
{
"event_id": "evt_01hv6spb5cxrwekm2agmr173c1",
"event_type": "discount.updated",
"occurred_at": "2024-04-11T14:41:22.604848Z",
"notification_id": "ntf_01hv6spb7v0f0tfg6wa3m8rgcr",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-11T14:41:22.604848Z |
Full schema: 25 fields.
From Paddle docs
-
Content type
application/json
discount_group.created
documented from Paddle docs (example)
discount_group.created New group for organizing discounts is created
Identified by event_type field in the body
Resource discount
{
"event_id": "evt_01hv6scz1kqjp8wx6ft1mc3kd2",
"event_type": "discount_group.created",
"occurred_at": "2024-11-28T14:36:15.283806Z",
"notification_id": "ntf_01hv6scz45nrn82tmkw4ywb71k",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-11-28T14:36:15.283806Z |
Full schema: 11 fields.
From Paddle docs
-
Content type
application/json
discount_group.updated
documented from Paddle docs (example)
discount_group.updated Discount group's name or status changes
Identified by event_type field in the body
Resource discount
{
"event_id": "evt_01hv6scz1kqjp8wx6ft1mc3kd2",
"event_type": "discount_group.updated",
"occurred_at": "2024-11-28T14:36:15.283806Z",
"notification_id": "ntf_01hv6scz45nrn82tmkw4ywb71k",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-11-28T14:36:15.283806Z |
Full schema: 11 fields.
From Paddle docs
-
Content type
application/json
price
price.created
documented from Paddle docs (example)
price.created New price is created
Identified by event_type field in the body
Resource price
{
"event_id": "evt_01hv0vaxeypbdcfw039a3gmc78",
"event_type": "price.created",
"occurred_at": "2024-04-09T07:14:38.686498Z",
"notification_id": "ntf_01hv0vaxj3znpd9vdpp3efa4n4",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-09T07:14:38.686498Z |
Full schema: 30 fields.
From Paddle docs
-
Content type
application/json
price.imported
documented from Paddle docs (example)
price.imported Price arrives through an import
Identified by event_type field in the body
Resource price
{
"event_id": "evt_01hgarz844zdfws6djn9rz6qm7",
"event_type": "price.imported",
"occurred_at": "2024-01-01T13:31:34.071379Z",
"notification_id": "ntf_01hd46rrqkrbndwzrarcew6t21",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-01-01T13:31:34.071379Z |
Full schema: 29 fields.
From Paddle docs
-
Content type
application/json
price.updated
documented from Paddle docs (example)
price.updated Price details change
Identified by event_type field in the body
Resource price
{
"event_id": "evt_01hv0vd770td3m64srybj8453a",
"event_type": "price.updated",
"occurred_at": "2024-04-09T07:15:54.208116Z",
"notification_id": "ntf_01hv0vd7900qdtv6h6w8m2h6qf",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-09T07:15:54.208116Z |
Full schema: 36 fields.
From Paddle docs
-
Content type
application/json
product
product.created
documented from Paddle docs (example)
product.created New product is created
Identified by event_type field in the body
Resource product
{
"event_id": "evt_01htz88y5k59y9rrv15p72dv91",
"event_type": "product.created",
"occurred_at": "2024-04-08T16:22:16.499189Z",
"notification_id": "ntf_01htz88y8sg8cww5jdj4q68yq0",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-08T16:22:16.499189Z |
Full schema: 26 fields.
From Paddle docs
-
Content type
application/json
product.imported
documented from Paddle docs (example)
product.imported Product arrives through an import
Identified by event_type field in the body
Resource product
{
"event_id": "evt_01hgas2cm8r02nxryp83jqvg6k",
"event_type": "product.imported",
"occurred_at": "2024-01-28T10:54:46.181Z",
"notification_id": "ntf_01hd46rqryfc8d7d5yz595k2k6",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-01-28T10:54:46.181Z |
Full schema: 18 fields.
From Paddle docs
-
Content type
application/json
product.updated
documented from Paddle docs (example)
product.updated Product details change
Identified by event_type field in the body
Resource product
{
"event_id": "evt_01htz8kd4g9npcy0c76y5pvrs5",
"event_type": "product.updated",
"occurred_at": "2024-04-08T16:27:59.504385Z",
"notification_id": "ntf_01htz8kd6sysr4sqefs5a9qqc0",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-08T16:27:59.504385Z |
Full schema: 26 fields.
From Paddle docs
-
Content type
application/json
subscription
subscription.activated
documented from Paddle docs (example)
subscription.activated Subscription turns active after any trial and a successful bill
Identified by event_type field in the body
Resource subscription
{
"event_id": "evt_01hv8x2adt2hy58b2w89p4py4d",
"event_type": "subscription.activated",
"occurred_at": "2024-04-12T10:18:49.658605Z",
"notification_id": "ntf_01hv8x2ag2hadnwngnf1qvegrp",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T10:18:49.658605Z |
Full schema: 86 fields.
From Paddle docs
-
Content type
application/json
subscription.canceled
documented from Paddle docs (example)
subscription.canceled Subscription moves to canceled
Identified by event_type field in the body
Resource subscription
{
"event_id": "evt_01hv90vbenb5d4spnjbbcfh3nk",
"event_type": "subscription.canceled",
"occurred_at": "2024-04-12T11:24:55.637846Z",
"notification_id": "ntf_01hv90vbk0t9skkjqazdq3emtz",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T11:24:55.637846Z |
Full schema: 84 fields.
From Paddle docs
-
Content type
application/json
subscription.created
documented from Paddle docs (example)
subscription.created New subscription is created
Identified by event_type field in the body
Resource subscription
{
"event_id": "evt_01hv8x2acma2gz7he8kg2s0hna",
"event_type": "subscription.created",
"occurred_at": "2024-04-12T10:18:49.621022Z",
"notification_id": "ntf_01hv8x2af22vrrz7k67g06x1kq",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T10:18:49.621022Z |
Full schema: 87 fields.
From Paddle docs
-
Content type
application/json
subscription.imported
documented from Paddle docs (example)
subscription.imported Subscription arrives through an import
Identified by event_type field in the body
Resource subscription
{
"event_id": "evt_01hv90ze5sg2gcazvqmqjwzcnf",
"event_type": "subscription.imported",
"occurred_at": "2024-04-12T11:27:09.497701Z",
"notification_id": "ntf_01hv90ze96bnqq3smhha1t9f4e",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T11:27:09.497701Z |
Full schema: 88 fields.
From Paddle docs
-
Content type
application/json
subscription.past_due
documented from Paddle docs (example)
subscription.past_due Subscription has an unpaid transaction
Identified by event_type field in the body
Resource subscription
{
"event_id": "evt_01hv8xby85a4vxfhgx493xvhjd",
"event_type": "subscription.past_due",
"occurred_at": "2024-05-12T10:19:26.014628Z",
"notification_id": "ntf_01hv8xbycgekeyat76j9ah2k3d",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-05-12T10:19:26.014628Z |
Full schema: 86 fields.
From Paddle docs
-
Content type
application/json
subscription.paused
documented from Paddle docs (example)
subscription.paused Subscription moves to paused
Identified by event_type field in the body
Resource subscription
{
"event_id": "evt_01hv95bn2k322d8y74ks0ppgmk",
"event_type": "subscription.paused",
"occurred_at": "2024-04-12T12:43:44.083397Z",
"notification_id": "ntf_01hv95bn52k92r8je00te7wfke",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T12:43:44.083397Z |
Full schema: 84 fields.
From Paddle docs
-
Content type
application/json
subscription.resumed
documented from Paddle docs (example)
subscription.resumed Paused subscription turns active and is billed again
Identified by event_type field in the body
Resource subscription
{
"event_id": "evt_01hv95drrfx0yapgmnv0x59kk7",
"event_type": "subscription.resumed",
"occurred_at": "2024-04-12T12:44:53.391712Z",
"notification_id": "ntf_01hv95drvs9bfmbtfgkrwsjgwa",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T12:44:53.391712Z |
Full schema: 86 fields.
From Paddle docs
-
Content type
application/json
subscription.trialing
documented from Paddle docs (example)
subscription.trialing Subscription starts a trial period
Identified by event_type field in the body
Resource subscription
{
"event_id": "evt_01hv915jfwxvzkq35bfnpxs9ck",
"event_type": "subscription.trialing",
"occurred_at": "2024-04-12T11:30:30.524449Z",
"notification_id": "ntf_01hv915jjxeqf1t0wrbqzkjh6g",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T11:30:30.524449Z |
Full schema: 97 fields.
From Paddle docs
-
Content type
application/json
subscription.updated
documented from Paddle docs (example)
subscription.updated Subscription changes, including items, billing details and scheduled changes
Identified by event_type field in the body
Resource subscription
{
"event_id": "evt_01hv8ytwcg91n07pa4jmvsdcst",
"event_type": "subscription.updated",
"occurred_at": "2024-04-12T10:49:43.056742Z",
"notification_id": "ntf_01hv8ytwevhn1sdtwzhf4rz548",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T10:49:43.056742Z |
Full schema: 96 fields.
From Paddle docs
-
Content type
application/json
transaction
transaction.billed
documented from Paddle docs (example)
transaction.billed Transaction is marked billed, typically for an invoice
Identified by event_type field in the body
Resource transaction
{
"event_id": "evt_01hv8xqmb9e8y66q4hb54cfsf9",
"event_type": "transaction.billed",
"occurred_at": "2024-04-12T10:30:27.945096Z",
"notification_id": "ntf_01hv8xqmdrrnsp7rvaf1264cp2",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T10:30:27.945096Z |
Full schema: 135 fields.
From Paddle docs
-
Content type
application/json
transaction.canceled
documented from Paddle docs (example)
transaction.canceled Transaction is canceled, typically an invoice raised in error
Identified by event_type field in the body
Resource transaction
{
"event_id": "evt_01hv8xsew895m2bswfcezebbjw",
"event_type": "transaction.canceled",
"occurred_at": "2024-04-12T10:31:27.880764Z",
"notification_id": "ntf_01hv8xseze1cnv8k83cnhtn4zr",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T10:31:27.880764Z |
Full schema: 135 fields.
From Paddle docs
-
Content type
application/json
transaction.completed
documented from Paddle docs (example)
transaction.completed Paddle finishes processing a paid transaction
Identified by event_type field in the body
Resource transaction
{
"event_id": "evt_01hv8x2axb33yr5y238zfwcn5p",
"event_type": "transaction.completed",
"occurred_at": "2024-04-12T10:18:50.155553Z",
"notification_id": "ntf_01hv8x2azy7scaan4s0eb0273x",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T10:18:50.155553Z |
Full schema: 163 fields.
From Paddle docs
-
Content type
application/json
transaction.created
documented from Paddle docs (example)
transaction.created New transaction is created, for example when checkout opens
Identified by event_type field in the body
Resource transaction
{
"event_id": "evt_01hv8wpv7nkct05j2zxxvpz6dm",
"event_type": "transaction.created",
"occurred_at": "2024-04-12T10:12:33.653418Z",
"notification_id": "ntf_01hv8wpva216nz1ykxf3m3vwyr",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T10:12:33.653418Z |
Full schema: 127 fields.
From Paddle docs
-
Content type
application/json
transaction.paid
documented from Paddle docs (example)
transaction.paid Payment is captured, before Paddle finishes processing
Identified by event_type field in the body
Resource transaction
{
"event_id": "evt_01hv8x29mtm3f42a00bp5v8va9",
"event_type": "transaction.paid",
"occurred_at": "2024-04-12T10:18:48.858999Z",
"notification_id": "ntf_01hv8x29q0j8ttnj51q5024qfp",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T10:18:48.858999Z |
Full schema: 147 fields.
From Paddle docs
-
Content type
application/json
transaction.past_due
documented from Paddle docs (example)
transaction.past_due Transaction payment is overdue or a renewal attempt failed
Identified by event_type field in the body
Resource transaction
{
"event_id": "evt_01hv8xbx1sxvjqpp24m7j3xthf",
"event_type": "transaction.past_due",
"occurred_at": "2024-04-12T10:24:03.642083Z",
"notification_id": "ntf_01hv8xbx5rj101psexq5wndwd3",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T10:24:03.642083Z |
Full schema: 157 fields.
From Paddle docs
-
Content type
application/json
transaction.payment_failed
documented from Paddle docs (example)
transaction.payment_failed Payment attempt fails
Identified by event_type field in the body
Resource transaction
{
"event_id": "evt_01hv8wx4vr9w6zsv6xss0b8az9",
"event_type": "transaction.payment_failed",
"occurred_at": "2024-04-12T10:16:00.120972Z",
"notification_id": "ntf_01hv8wx4ywcj8pptnpeq1rrvzm",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T10:16:00.120972Z |
Full schema: 147 fields.
From Paddle docs
-
Content type
application/json
transaction.ready
documented from Paddle docs (example)
transaction.ready Transaction has the fields it needs to be billed
Identified by event_type field in the body
Resource transaction
{
"event_id": "evt_01hv8wt9q80exvgq58y668kszj",
"event_type": "transaction.ready",
"occurred_at": "2024-04-12T10:14:26.792582Z",
"notification_id": "ntf_01hv8wt9sx34v7vmjffpbt4dbt",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T10:14:26.792582Z |
Full schema: 127 fields.
From Paddle docs
-
Content type
application/json
transaction.revised
documented from Paddle docs (example)
transaction.revised Customer details change on a billed or completed transaction
Identified by event_type field in the body
Resource transaction
{
"event_id": "evt_01hzpwdkc41q67tbawb73h0t7p",
"event_type": "transaction.revised",
"occurred_at": "2024-06-06T13:39:40.036493Z",
"notification_id": "ntf_01hzpwdkj9akeqyv4padq7ndwc",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-06-06T13:39:40.036493Z |
Full schema: 135 fields.
From Paddle docs
-
Content type
application/json
transaction.updated
documented from Paddle docs (example)
transaction.updated Transaction changes, often adding fields after a status event
Identified by event_type field in the body
Resource transaction
{
"event_id": "evt_01hv8vzzb6rhnvxtf571ddsfgs",
"event_type": "transaction.updated",
"occurred_at": "2024-04-12T10:00:04.198351Z",
"notification_id": "ntf_01hv8vzzejmbstvpmpa2qf7sct",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-12T10:00:04.198351Z |
Full schema: 135 fields.
From Paddle docs
-
Content type
application/json
Other Paddle events
adjustment.created
documented from Paddle docs (example)
adjustment.created Refund or credit is raised against a transaction
Identified by event_type field in the body
{
"event_id": "evt_01hvgf2skkg8dsk5dczemw2bx1",
"event_type": "adjustment.created",
"occurred_at": "2024-04-15T08:48:20.595926Z",
"notification_id": "ntf_01hvgf2spk3bvewnw8t2zrnbmb",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-15T08:48:20.595926Z |
Full schema: 48 fields.
From Paddle docs
-
Content type
application/json
adjustment.updated
documented from Paddle docs (example)
adjustment.updated Paddle approves or rejects a refund that needed review
Identified by event_type field in the body
{
"event_id": "evt_01hvgfdfepj8eaevsjh5g4swbe",
"event_type": "adjustment.updated",
"occurred_at": "2024-04-15T08:54:10.646377Z",
"notification_id": "ntf_01hvgfdfhwncqrrjz1nz5eky9a",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-15T08:54:10.646377Z |
Full schema: 48 fields.
From Paddle docs
-
Content type
application/json
meter.created
documented from Paddle docs (example)
meter.created New usage meter is created (usage billing beta)
Identified by event_type field in the body
{
"event_id": "evt_01kw8tj8fq5rp3n7m0h9d4vsb2",
"event_type": "meter.created",
"occurred_at": "2026-09-01T09:10:00.283806Z",
"notification_id": "ntf_01kw8tj9k7v2ah6y8pxr3q1nfe",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2026-09-01T09:10:00.283806Z |
Full schema: 17 fields.
From Paddle docs
-
Content type
application/json
meter.updated
documented from Paddle docs (example)
meter.updated Usage meter changes or is archived (usage billing beta)
Identified by event_type field in the body
{
"event_id": "evt_01kw8vh2m5r7wq4s9t6xka2vjy",
"event_type": "meter.updated",
"occurred_at": "2026-09-10T12:03:41.823806Z",
"notification_id": "ntf_01kw8vh38b1zpm2v7q4rd0xnaf",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2026-09-10T12:03:41.823806Z |
Full schema: 17 fields.
From Paddle docs
-
Content type
application/json
payment_method.deleted
documented from Paddle docs (example)
payment_method.deleted Saved payment method is removed or replaced
Identified by event_type field in the body
{
"event_id": "evt_01hwz6k64a210xcvsdbg3y4vmr",
"event_type": "payment_method.deleted",
"occurred_at": "2024-05-03T12:24:18.826338Z",
"notification_id": "ntf_01hwz6k66fp6cxtxyt6551wv7z",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-05-03T12:24:18.826338Z |
Full schema: 13 fields.
From Paddle docs
-
Content type
application/json
payment_method.saved
documented from Paddle docs (example)
payment_method.saved Payment method is stored for a customer
Identified by event_type field in the body
{
"event_id": "evt_01hwvkmsge7bhq1a31s35784zt",
"event_type": "payment_method.saved",
"occurred_at": "2024-05-02T02:55:25.198953Z",
"notification_id": "ntf_01hwvkmsknrgqw4z1598qw4ypt",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-05-02T02:55:25.198953Z |
Full schema: 12 fields.
From Paddle docs
-
Content type
application/json
payout.created
documented from Paddle docs (example)
payout.created Paddle starts a payout to you
Identified by event_type field in the body
{
"event_id": "evt_01h2b06f69w9aw3eymqs1dfa2q",
"event_type": "payout.created",
"occurred_at": "2023-06-01T13:30:38.138984Z",
"notification_id": "ntf_01h2b06f84qsjzdw8rywe3j4gt",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2023-06-01T13:30:38.138984Z |
Full schema: 10 fields.
From Paddle docs
-
Content type
application/json
payout.paid
documented from Paddle docs (example)
payout.paid Payout is paid out, usually a working day before funds land
Identified by event_type field in the body
{
"event_id": "evt_01h2b0tqg1xkgnkfmprsnrjn0s",
"event_type": "payout.paid",
"occurred_at": "2023-06-07T13:30:38.138984Z",
"notification_id": "ntf_01h2b0tqkhfqd094y9pys30xyw",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2023-06-07T13:30:38.138984Z |
Full schema: 10 fields.
From Paddle docs
-
Content type
application/json
report.created
documented from Paddle docs (example)
report.created Report is requested and starts generating
Identified by event_type field in the body
{
"event_id": "evt_01hvgdpb99hxbjje8npcvk3za0",
"event_type": "report.created",
"occurred_at": "2024-04-15T08:24:04.137829Z",
"notification_id": "ntf_01hvgdpbc5rqqxh6j1daqs7n3x",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-15T08:24:04.137829Z |
Full schema: 17 fields.
From Paddle docs
-
Content type
application/json
report.updated
documented from Paddle docs (example)
report.updated Report finishes generating and is ready to download
Identified by event_type field in the body
{
"event_id": "evt_01hvgdpmap3espxga4jwzb0agp",
"event_type": "report.updated",
"occurred_at": "2024-04-15T08:24:13.398892Z",
"notification_id": "ntf_01hvgdpmd2g0dv4vpmys3z7bc3",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2024-04-15T08:24:13.398892Z |
Full schema: 17 fields.
From Paddle docs
-
Content type
application/json
usage_balance.depleted
documented from Paddle docs (example)
usage_balance.depleted Customer's usage balance reaches zero (usage billing beta)
Identified by event_type field in the body
{
"event_id": "evt_01js2n02s4fr6a8gvfm5enq0as",
"event_type": "usage_balance.depleted",
"occurred_at": "2026-09-27T16:42:10.283806Z",
"notification_id": "ntf_01js2n03f91aw3v7q6f7x55r3z",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
occurred_at | string | 2026-09-27T16:42:10.283806Z |
Full schema: 19 fields.
From Paddle docs
-
Content type
application/json
Route Paddle events by type.
Event Gateway receives every Paddle delivery and filters and routes it by event type, so each service gets only the events it handles.