price.created

Occurs when a price is created.

event_idstring

Unique Paddle ID for this event, prefixed with evt_.

event_typestring

Type of event sent by Paddle, in the format entity.event_type.

occurred_atstring<date-time>

RFC 3339 datetime string of when this event occurred.

notification_idstring

Unique Paddle ID for this notification, prefixed with ntf_.

dataobject

Represents a price entity.

idstring

Unique Paddle ID for this price, prefixed with pri_.

product_idstring

Paddle ID for the product that this price is for, prefixed with pro_.

descriptionstring

Short description for this price. Typically describes how often the related product bills.

billing_cycleobject or null

How often this price should be charged. null if price is non-recurring (one-time).

trial_periodobject or null

Trial period for the product related to this price. The billing cycle begins once the trial period is over. null for no trial period. Requires billing_cycle.

tax_modestring

How tax is calculated for this price.

unit_priceobject

Base price. This price applies to all customers, except for customers located in countries where you have unit_price_overrides.

unit_price_overridesarray[object]

List of unit price overrides. Use to override the base price with a custom price and currency for a country or group of countries.

quantityobject

Limits on how many times the related product can be purchased at this price. Useful for discount campaigns.

statusstring

Whether this entity can be used in Paddle.

custom_dataobject or null

Your own structured key-value data.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
1{
2  "event_id": "evt_01h7zd9n8vch227m3dgwqcvf6t",
3  "event_type": "price.created",
4  "occurred_at": "2023-08-16T14:51:48.380054Z",
5  "notification_id": "ntf_01h7zd9nb2j92yhbfys5zam0gq",
6  "data": {
7    "id": "pri_01h7zd9mzfq79850w4ryc39v38",
8    "status": "active",
9    "quantity": {
10      "maximum": 999,
11      "minimum": 1
12    },
13    "tax_mode": "account_setting",
14    "product_id": "pro_01h7zcgmdc6tmwtjehp3sh7azf",
15    "unit_price": {
16      "amount": "500",
17      "currency_code": "USD"
18    },
19    "custom_data": null,
20    "description": "Monthly (per seat)",