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)

Customer address is added

Identified by event_type field in the body Resource address

paddle-address-created.json
{
  "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

Send example to Inspect → View as JSON

address.imported

documented from Paddle docs (example)

Address arrives through an import

Identified by event_type field in the body Resource address

paddle-address-imported.json
{
  "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

Send example to Inspect → View as JSON

address.updated

documented from Paddle docs (example)

Address details change

Identified by event_type field in the body Resource address

paddle-address-updated.json
{
  "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

Send example to Inspect → View as JSON

api_key

api_key.created

documented from Paddle docs (example)

New API key is created

Identified by event_type field in the body Resource api_key

paddle-api-key-created.json
{
  "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

Send example to Inspect → View as JSON

api_key.expired

documented from Paddle docs (example)

API key passes its expiry date and stops working

Identified by event_type field in the body Resource api_key

paddle-api-key-expired.json
{
  "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

Send example to Inspect → View as JSON

api_key.expiring

documented from Paddle docs (example)

API key has seven days or fewer left

Identified by event_type field in the body Resource api_key

paddle-api-key-expiring.json
{
  "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

Send example to Inspect → View as JSON

api_key.revoked

documented from Paddle docs (example)

API key is revoked

Identified by event_type field in the body Resource api_key

paddle-api-key-revoked.json
{
  "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

Send example to Inspect → View as JSON

api_key.updated

documented from Paddle docs (example)

API key details change

Identified by event_type field in the body Resource api_key

paddle-api-key-updated.json
{
  "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

Send example to Inspect → View as JSON

api_key_exposure.created

documented from Paddle docs (example)

Paddle finds an API key exposed publicly and revokes it

Identified by event_type field in the body Resource api_key

paddle-api-key-exposure-created.json
{
  "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

Send example to Inspect → View as JSON

business

business.created

documented from Paddle docs (example)

Customer business record is added

Identified by event_type field in the body Resource business

paddle-business-created.json
{
  "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

Send example to Inspect → View as JSON

business.imported

documented from Paddle docs (example)

Business record arrives through an import

Identified by event_type field in the body Resource business

paddle-business-imported.json
{
  "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

Send example to Inspect → View as JSON

business.updated

documented from Paddle docs (example)

Business details change

Identified by event_type field in the body Resource business

paddle-business-updated.json
{
  "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

Send example to Inspect → View as JSON

client_token

client_token.created

documented from Paddle docs (example)

New client-side token is created

Identified by event_type field in the body Resource client_token

paddle-client-token-created.json
{
  "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

Send example to Inspect → View as JSON

client_token.revoked

documented from Paddle docs (example)

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

Identified by event_type field in the body Resource client_token

paddle-client-token-revoked.json
{
  "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

Send example to Inspect → View as JSON

client_token.updated

documented from Paddle docs (example)

Client-side token details change

Identified by event_type field in the body Resource client_token

paddle-client-token-updated.json
{
  "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

Send example to Inspect → View as JSON

customer

customer.created

documented from Paddle docs (example)

New customer is created

Identified by event_type field in the body Resource customer

paddle-customer-created.json
{
  "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

Send example to Inspect → View as JSON

customer.imported

documented from Paddle docs (example)

Customer arrives through an import

Identified by event_type field in the body Resource customer

paddle-customer-imported.json
{
  "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

Send example to Inspect → View as JSON

customer.updated

documented from Paddle docs (example)

Customer details change

Identified by event_type field in the body Resource customer

paddle-customer-updated.json
{
  "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

Send example to Inspect → View as JSON

discount

discount.created

documented from Paddle docs (example)

New discount is created

Identified by event_type field in the body Resource discount

paddle-discount-created.json
{
  "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

Send example to Inspect → View as JSON

discount.imported

documented from Paddle docs (example)

Discount arrives through an import

Identified by event_type field in the body Resource discount

paddle-discount-imported.json
{
  "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

Send example to Inspect → View as JSON

discount.updated

documented from Paddle docs (example)

Discount details change

Identified by event_type field in the body Resource discount

paddle-discount-updated.json
{
  "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

Send example to Inspect → View as JSON

discount_group.created

documented from Paddle docs (example)

New group for organizing discounts is created

Identified by event_type field in the body Resource discount

paddle-discount-group-created.json
{
  "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

Send example to Inspect → View as JSON

discount_group.updated

documented from Paddle docs (example)

Discount group's name or status changes

Identified by event_type field in the body Resource discount

paddle-discount-group-updated.json
{
  "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

Send example to Inspect → View as JSON

price

price.created

documented from Paddle docs (example)

New price is created

Identified by event_type field in the body Resource price

paddle-price-created.json
{
  "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

Send example to Inspect → View as JSON

price.imported

documented from Paddle docs (example)

Price arrives through an import

Identified by event_type field in the body Resource price

paddle-price-imported.json
{
  "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

Send example to Inspect → View as JSON

price.updated

documented from Paddle docs (example)

Price details change

Identified by event_type field in the body Resource price

paddle-price-updated.json
{
  "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

Send example to Inspect → View as JSON

product

product.created

documented from Paddle docs (example)

New product is created

Identified by event_type field in the body Resource product

paddle-product-created.json
{
  "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

Send example to Inspect → View as JSON

product.imported

documented from Paddle docs (example)

Product arrives through an import

Identified by event_type field in the body Resource product

paddle-product-imported.json
{
  "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

Send example to Inspect → View as JSON

product.updated

documented from Paddle docs (example)

Product details change

Identified by event_type field in the body Resource product

paddle-product-updated.json
{
  "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

Send example to Inspect → View as JSON

subscription

subscription.activated

documented from Paddle docs (example)

Subscription turns active after any trial and a successful bill

Identified by event_type field in the body Resource subscription

paddle-subscription-activated.json
{
  "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

Send example to Inspect → View as JSON

subscription.canceled

documented from Paddle docs (example)

Subscription moves to canceled

Identified by event_type field in the body Resource subscription

paddle-subscription-canceled.json
{
  "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

Send example to Inspect → View as JSON

subscription.created

documented from Paddle docs (example)

New subscription is created

Identified by event_type field in the body Resource subscription

paddle-subscription-created.json
{
  "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

Send example to Inspect → View as JSON

subscription.imported

documented from Paddle docs (example)

Subscription arrives through an import

Identified by event_type field in the body Resource subscription

paddle-subscription-imported.json
{
  "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

Send example to Inspect → View as JSON

subscription.past_due

documented from Paddle docs (example)

Subscription has an unpaid transaction

Identified by event_type field in the body Resource subscription

paddle-subscription-past-due.json
{
  "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

Send example to Inspect → View as JSON

subscription.paused

documented from Paddle docs (example)

Subscription moves to paused

Identified by event_type field in the body Resource subscription

paddle-subscription-paused.json
{
  "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

Send example to Inspect → View as JSON

subscription.resumed

documented from Paddle docs (example)

Paused subscription turns active and is billed again

Identified by event_type field in the body Resource subscription

paddle-subscription-resumed.json
{
  "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

Send example to Inspect → View as JSON

subscription.trialing

documented from Paddle docs (example)

Subscription starts a trial period

Identified by event_type field in the body Resource subscription

paddle-subscription-trialing.json
{
  "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

Send example to Inspect → View as JSON

subscription.updated

documented from Paddle docs (example)

Subscription changes, including items, billing details and scheduled changes

Identified by event_type field in the body Resource subscription

paddle-subscription-updated.json
{
  "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

Send example to Inspect → View as JSON

transaction

transaction.billed

documented from Paddle docs (example)

Transaction is marked billed, typically for an invoice

Identified by event_type field in the body Resource transaction

paddle-transaction-billed.json
{
  "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

Send example to Inspect → View as JSON

transaction.canceled

documented from Paddle docs (example)

Transaction is canceled, typically an invoice raised in error

Identified by event_type field in the body Resource transaction

paddle-transaction-canceled.json
{
  "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

Send example to Inspect → View as JSON

transaction.completed

documented from Paddle docs (example)

Paddle finishes processing a paid transaction

Identified by event_type field in the body Resource transaction

paddle-transaction-completed.json
{
  "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

Send example to Inspect → View as JSON

transaction.created

documented from Paddle docs (example)

New transaction is created, for example when checkout opens

Identified by event_type field in the body Resource transaction

paddle-transaction-created.json
{
  "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

Send example to Inspect → View as JSON

transaction.paid

documented from Paddle docs (example)

Payment is captured, before Paddle finishes processing

Identified by event_type field in the body Resource transaction

paddle-transaction-paid.json
{
  "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

Send example to Inspect → View as JSON

transaction.past_due

documented from Paddle docs (example)

Transaction payment is overdue or a renewal attempt failed

Identified by event_type field in the body Resource transaction

paddle-transaction-past-due.json
{
  "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

Send example to Inspect → View as JSON

transaction.payment_failed

documented from Paddle docs (example)

Payment attempt fails

Identified by event_type field in the body Resource transaction

paddle-transaction-payment-failed.json
{
  "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

Send example to Inspect → View as JSON

transaction.ready

documented from Paddle docs (example)

Transaction has the fields it needs to be billed

Identified by event_type field in the body Resource transaction

paddle-transaction-ready.json
{
  "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

Send example to Inspect → View as JSON

transaction.revised

documented from Paddle docs (example)

Customer details change on a billed or completed transaction

Identified by event_type field in the body Resource transaction

paddle-transaction-revised.json
{
  "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

Send example to Inspect → View as JSON

transaction.updated

documented from Paddle docs (example)

Transaction changes, often adding fields after a status event

Identified by event_type field in the body Resource transaction

paddle-transaction-updated.json
{
  "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

Send example to Inspect → View as JSON

Other Paddle events

adjustment.created

documented from Paddle docs (example)

Refund or credit is raised against a transaction

Identified by event_type field in the body

paddle-adjustment-created.json
{
  "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

Send example to Inspect → View as JSON

adjustment.updated

documented from Paddle docs (example)

Paddle approves or rejects a refund that needed review

Identified by event_type field in the body

paddle-adjustment-updated.json
{
  "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

Send example to Inspect → View as JSON

meter.created

documented from Paddle docs (example)

New usage meter is created (usage billing beta)

Identified by event_type field in the body

paddle-meter-created.json
{
  "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

Send example to Inspect → View as JSON

meter.updated

documented from Paddle docs (example)

Usage meter changes or is archived (usage billing beta)

Identified by event_type field in the body

paddle-meter-updated.json
{
  "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

Send example to Inspect → View as JSON

payment_method.deleted

documented from Paddle docs (example)

Saved payment method is removed or replaced

Identified by event_type field in the body

paddle-payment-method-deleted.json
{
  "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

Send example to Inspect → View as JSON

payment_method.saved

documented from Paddle docs (example)

Payment method is stored for a customer

Identified by event_type field in the body

paddle-payment-method-saved.json
{
  "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

Send example to Inspect → View as JSON

payout.created

documented from Paddle docs (example)

Paddle starts a payout to you

Identified by event_type field in the body

paddle-payout-created.json
{
  "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

Send example to Inspect → View as JSON

payout.paid

documented from Paddle docs (example)

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

Identified by event_type field in the body

paddle-payout-paid.json
{
  "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

Send example to Inspect → View as JSON

report.created

documented from Paddle docs (example)

Report is requested and starts generating

Identified by event_type field in the body

paddle-report-created.json
{
  "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

Send example to Inspect → View as JSON

report.updated

documented from Paddle docs (example)

Report finishes generating and is ready to download

Identified by event_type field in the body

paddle-report-updated.json
{
  "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

Send example to Inspect → View as JSON

usage_balance.depleted

documented from Paddle docs (example)

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

Identified by event_type field in the body

paddle-usage-balance-depleted.json
{
  "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

Send example to Inspect → View as 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.

Not affiliated with Paddle. Facts are compiled from public sources and linked inline.