> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt). # price.created Occurs when a price is created. --- Occurs when a price is created. `created_at` and `updated_at` may be `null` in events that occurred before this field was added to price entities. ## Schema ```json { "type": "object", "required": [ "event_id", "event_type", "occurred_at", "notification_id", "data" ], "properties": { "event_id": { "type": "string", "pattern": "^evt_[a-z\\d]{26}$", "description": "Unique Paddle ID for this event, prefixed with `evt_`.", "title": "Event ID", "examples": [ "evt_01gks14ge726w50ch2tmaw2a1x" ] }, "event_type": { "type": "string", "enum": [ "address.created", "address.imported", "address.updated", "adjustment.created", "adjustment.updated", "api_key.created", "api_key.expired", "api_key.expiring", "api_key.revoked", "api_key.updated", "api_key_exposure.created", "business.created", "business.imported", "business.updated", "client_token.created", "client_token.revoked", "client_token.updated", "customer.created", "customer.imported", "customer.updated", "discount.created", "discount.imported", "discount.updated", "discount_group.created", "discount_group.updated", "payment_method.saved", "payment_method.deleted", "payout.created", "payout.paid", "price.created", "price.imported", "price.updated", "product.created", "product.imported", "product.updated", "report.created", "report.updated", "subscription.activated", "subscription.canceled", "subscription.created", "subscription.imported", "subscription.past_due", "subscription.paused", "subscription.resumed", "subscription.trialing", "subscription.updated", "transaction.billed", "transaction.canceled", "transaction.completed", "transaction.created", "transaction.paid", "transaction.past_due", "transaction.payment_failed", "transaction.ready", "transaction.revised", "transaction.updated" ], "description": "Type of event sent by Paddle, in the format `entity.event_type`.", "title": "Event type name", "x-enum-descriptions": { "address.created": { "description": "An [`address.created`](https://developer.paddle.com/webhooks/addresses/address-created) event." }, "address.imported": { "description": "An [`address.imported`](https://developer.paddle.com/webhooks/addresses/address-imported) event." }, "address.updated": { "description": "An [`address.updated`](https://developer.paddle.com/webhooks/addresses/address-updated) event." }, "adjustment.created": { "description": "An [`adjustment.created`](https://developer.paddle.com/webhooks/adjustments/adjustment-created) event." }, "adjustment.updated": { "description": "An [`adjustment.updated`](https://developer.paddle.com/webhooks/adjustments/adjustment-updated) event." }, "api_key.created": { "description": "An [`api_key.created`](https://developer.paddle.com/webhooks/api-keys/api-key-created) event." }, "api_key.expired": { "description": "An [`api_key.expired`](https://developer.paddle.com/webhooks/api-keys/api-key-expired) event." }, "api_key.expiring": { "description": "An [`api_key.expiring`](https://developer.paddle.com/webhooks/api-keys/api-key-expiring) event." }, "api_key.revoked": { "description": "An [`api_key.revoked`](https://developer.paddle.com/webhooks/api-keys/api-key-revoked) event." }, "api_key.updated": { "description": "An [`api_key.updated`](https://developer.paddle.com/webhooks/api-keys/api-key-updated) event." }, "api_key_exposure.created": { "description": "An [`api_key_exposure.created`](https://developer.paddle.com/webhooks/api-key-exposures/api-key-exposure-created) event." }, "business.created": { "description": "A [`business.created`](https://developer.paddle.com/webhooks/businesses/business-created) event." }, "business.imported": { "description": "A [`business.imported`](https://developer.paddle.com/webhooks/businesses/business-imported) event." }, "business.updated": { "description": "A [`business.updated`](https://developer.paddle.com/webhooks/businesses/business-updated) event." }, "client_token.created": { "description": "A [`client_token.created`](https://developer.paddle.com/webhooks/client-tokens/client-token-created) event." }, "client_token.revoked": { "description": "A [`client_token.revoked`](https://developer.paddle.com/webhooks/client-tokens/client-token-revoked) event." }, "client_token.updated": { "description": "A [`client_token.updated`](https://developer.paddle.com/webhooks/client-tokens/client-token-updated) event." }, "customer.created": { "description": "A [`customer.created`](https://developer.paddle.com/webhooks/customers/customer-created) event." }, "customer.imported": { "description": "A [`customer.imported`](https://developer.paddle.com/webhooks/customers/customer-imported) event." }, "customer.updated": { "description": "A [`customer.updated`](https://developer.paddle.com/webhooks/customers/customer-updated) event." }, "discount.created": { "description": "A [`discount.created`](https://developer.paddle.com/webhooks/discounts/discount-created) event." }, "discount.imported": { "description": "A [`discount.imported`](https://developer.paddle.com/webhooks/discounts/discount-imported) event." }, "discount.updated": { "description": "A [`discount.updated`](https://developer.paddle.com/webhooks/discounts/discount-updated) event." }, "discount_group.created": { "description": "A [`discount_group.created`](https://developer.paddle.com/webhooks/discount-groups/discount-group-created) event." }, "discount_group.updated": { "description": "A [`discount_group.updated`](https://developer.paddle.com/webhooks/discount-groups/discount-group-updated) event." }, "payment_method.saved": { "description": "A [`payment_method.saved`](https://developer.paddle.com/webhooks/payment-methods/payment-method-saved) event." }, "payment_method.deleted": { "description": "A [`payment_method.deleted`](https://developer.paddle.com/webhooks/payment-methods/payment-method-deleted) event." }, "payout.created": { "description": "A [`payout.created`](https://developer.paddle.com/webhooks/payouts/payout-created) event." }, "payout.paid": { "description": "A [`payout.paid`](https://developer.paddle.com/webhooks/payouts/payout-paid) event." }, "price.created": { "description": "A [`price.created`](https://developer.paddle.com/webhooks/prices/price-created) event." }, "price.imported": { "description": "A [`price.imported`](https://developer.paddle.com/webhooks/prices/price-imported) event." }, "price.updated": { "description": "A [`price.updated`](https://developer.paddle.com/webhooks/prices/price-updated) event." }, "product.created": { "description": "A [`product.created`](https://developer.paddle.com/webhooks/products/product-created) event." }, "product.imported": { "description": "A [`product.imported`](https://developer.paddle.com/webhooks/products/product-imported) event." }, "product.updated": { "description": "A [`product.updated`](https://developer.paddle.com/webhooks/products/product-updated) event." }, "report.created": { "description": "A [`report.created`](https://developer.paddle.com/webhooks/reports/report-created) event." }, "report.updated": { "description": "A [`report.updated`](https://developer.paddle.com/webhooks/reports/report-updated) event." }, "subscription.activated": { "description": "A [`subscription.activated`](https://developer.paddle.com/webhooks/subscriptions/subscription-activated) event." }, "subscription.canceled": { "description": "A [`subscription.canceled`](https://developer.paddle.com/webhooks/subscriptions/subscription-canceled) event." }, "subscription.created": { "description": "A [`subscription.created`](https://developer.paddle.com/webhooks/subscriptions/subscription-created) event." }, "subscription.imported": { "description": "A [`subscription.imported`](https://developer.paddle.com/webhooks/subscriptions/subscription-imported) event." }, "subscription.past_due": { "description": "A [`subscription.past_due`](https://developer.paddle.com/webhooks/subscriptions/subscription-past-due) event." }, "subscription.paused": { "description": "A [`subscription.paused`](https://developer.paddle.com/webhooks/subscriptions/subscription-paused) event." }, "subscription.resumed": { "description": "A [`subscription.resumed`](https://developer.paddle.com/webhooks/subscriptions/subscription-resumed) event." }, "subscription.trialing": { "description": "A [`subscription.trialing`](https://developer.paddle.com/webhooks/subscriptions/subscription-trialing) event." }, "subscription.updated": { "description": "A [`subscription.updated`](https://developer.paddle.com/webhooks/subscriptions/subscription-updated) event." }, "transaction.billed": { "description": "A [`transaction.billed`](https://developer.paddle.com/webhooks/transactions/transaction-billed) event." }, "transaction.canceled": { "description": "A [`transaction.canceled`](https://developer.paddle.com/webhooks/transactions/transaction-canceled) event." }, "transaction.completed": { "description": "A [`transaction.completed`](https://developer.paddle.com/webhooks/transactions/transaction-completed) event." }, "transaction.created": { "description": "A [`transaction.created`](https://developer.paddle.com/webhooks/transactions/transaction-created) event." }, "transaction.paid": { "description": "A [`transaction.paid`](https://developer.paddle.com/webhooks/transactions/transaction-paid) event." }, "transaction.past_due": { "description": "A [`transaction.past_due`](https://developer.paddle.com/webhooks/transactions/transaction-past-due) event." }, "transaction.payment_failed": { "description": "A [`transaction.payment_failed`](https://developer.paddle.com/webhooks/transactions/transaction-payment-failed) event." }, "transaction.ready": { "description": "A [`transaction.ready`](https://developer.paddle.com/webhooks/transactions/transaction-ready) event." }, "transaction.revised": { "description": "A [`transaction.revised`](https://developer.paddle.com/webhooks/transactions/transaction-revised) event." }, "transaction.updated": { "description": "A [`transaction.updated`](https://developer.paddle.com/webhooks/transactions/transaction-updated) event." } } }, "occurred_at": { "type": "string", "format": "date-time", "description": "RFC 3339 datetime string of when this event occurred.", "title": "Timestamp", "examples": [ "2024-10-12T07:20:50.52Z" ] }, "notification_id": { "type": "string", "pattern": "^ntf_[a-z\\d]{26}$", "description": "Unique Paddle ID for this notification, prefixed with `ntf_`.", "title": "Notification ID", "examples": [ "ntf_01ghbkd0frb9k95cnhwd1bxpvk" ] }, "data": { "properties": { "id": { "type": "string", "pattern": "^pri_[a-z\\d]{26}$", "description": "Unique Paddle ID for this price, prefixed with `pri_`.", "title": "Price ID", "examples": [ "pri_01gsz8x8sawmvhz1pv30nge1ke" ] }, "product_id": { "type": "string", "pattern": "^pro_[a-z\\d]{26}$", "description": "Paddle ID for the product that this price is for, prefixed with `pro_`.", "title": "Product ID", "examples": [ "pro_01gsz97mq9pa4fkyy0wqenepkz" ] }, "description": { "type": "string", "minLength": 2, "maxLength": 500, "description": "Internal description for this price, not shown to customers. Typically notes for your team." }, "type": { "anyOf": [ { "type": "string", "enum": [ "custom", "standard" ], "description": "Type of item. Standard items are considered part of your catalog and are shown in the Paddle dashboard.", "title": "CatalogType", "x-enum-descriptions": { "custom": { "description": "Non-catalog item. Typically created for a specific transaction or subscription. Not returned when listing or shown in the Paddle dashboard." }, "standard": { "description": "Standard item. Can be considered part of your catalog and reused across transactions and subscriptions easily." } } }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 150, "description": "Name of this price, shown to customers at checkout and on invoices. Typically describes how often the related product bills.", "title": "Price Name" }, { "type": "null" } ], "description": "Name of this price, shown to customers at checkout and on invoices. Typically describes how often the related product bills." }, "billing_cycle": { "anyOf": [ { "type": "object", "required": [ "interval", "frequency" ], "properties": { "interval": { "type": "string", "enum": [ "day", "week", "month", "year" ], "description": "Unit of time." }, "frequency": { "type": "integer", "minimum": 1, "description": "Amount of time." } }, "title": "Duration" }, { "type": "null" } ], "description": "How often this price should be charged. `null` if price is non-recurring (one-time)." }, "trial_period": { "anyOf": [ { "type": "object", "required": [ "interval", "frequency", "requires_payment_method" ], "properties": { "interval": { "type": "string", "enum": [ "day", "week", "month", "year" ], "description": "Unit of time." }, "frequency": { "type": "integer", "minimum": 1, "description": "Amount of time." }, "requires_payment_method": { "type": "boolean", "description": "Whether this price requires a payment method (`true`) or not (`false`) when trialing. If `false`, customers can sign up for subscription without entering their payment details, often referred to as a \"cardless trial.\"", "title": "Price Requires Payment Method", "default": true } }, "title": "Price Trial Duration" }, { "type": "null" } ], "description": "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_mode": { "type": "string", "enum": [ "account_setting", "external", "internal", "location" ], "description": "How tax is calculated for this price.", "title": "Tax mode", "x-enum-descriptions": { "account_setting": { "description": "Prices use the setting from your account." }, "external": { "description": "Prices are exclusive of tax." }, "internal": { "description": "Prices are inclusive of tax." }, "location": { "description": "Prices are inclusive or exclusive of tax, depending on the country of the transaction." } } }, "unit_price": { "properties": { "amount": { "type": "string", "description": "Amount in the lowest denomination for the currency, e.g. 10 USD = 1000 (cents). Although represented as a string, this value must be a valid integer." }, "currency_code": { "type": "string", "enum": [ "USD", "EUR", "GBP", "JPY", "AUD", "CAD", "CHF", "HKD", "SGD", "SEK", "ARS", "BRL", "CLP", "CNY", "COP", "CZK", "DKK", "HUF", "ILS", "INR", "KRW", "MXN", "NOK", "NZD", "PEN", "PLN", "RUB", "THB", "TRY", "TWD", "UAH", "VND", "ZAR" ], "description": "Supported three-letter ISO 4217 currency code.", "title": "Currency code", "x-enum-descriptions": { "USD": { "description": "United States Dollar" }, "EUR": { "description": "Euro" }, "GBP": { "description": "Pound Sterling" }, "JPY": { "description": "Japanese Yen" }, "AUD": { "description": "Australian Dollar" }, "CAD": { "description": "Canadian Dollar" }, "CHF": { "description": "Swiss Franc" }, "HKD": { "description": "Hong Kong Dollar" }, "SGD": { "description": "Singapore Dollar" }, "SEK": { "description": "Swedish Krona" }, "ARS": { "description": "Argentine Peso" }, "BRL": { "description": "Brazilian Real" }, "CLP": { "description": "Chilean Peso" }, "CNY": { "description": "Chinese Yuan" }, "COP": { "description": "Colombian Peso" }, "CZK": { "description": "Czech Koruna" }, "DKK": { "description": "Danish Krone" }, "HUF": { "description": "Hungarian Forint" }, "ILS": { "description": "Israeli Shekel" }, "INR": { "description": "Indian Rupee" }, "KRW": { "description": "South Korean Won" }, "MXN": { "description": "Mexican Peso" }, "NOK": { "description": "Norwegian Krone" }, "NZD": { "description": "New Zealand Dollar" }, "PEN": { "description": "Peruvian Sol" }, "PLN": { "description": "Polish Zloty" }, "RUB": { "description": "Russian Ruble" }, "THB": { "description": "Thai Baht" }, "TRY": { "description": "Turkish Lira" }, "TWD": { "description": "New Taiwan Dollar" }, "UAH": { "description": "Ukrainian Hryvnia" }, "VND": { "description": "Vietnamese Dong" }, "ZAR": { "description": "South African Rand" } } } }, "required": [ "amount", "currency_code" ], "type": "object", "description": "Base price. This price applies to all customers, except for customers located in countries where you have `unit_price_overrides`.", "title": "Money" }, "unit_price_overrides": { "type": "array", "items": { "type": "object", "required": [ "country_codes", "unit_price" ], "properties": { "country_codes": { "type": "array", "items": { "oneOf": [ { "type": "string", "enum": [ "AD", "AE", "AG", "AI", "AL", "AM", "AO", "AR", "AS", "AT", "AU", "AW", "AX", "AZ", "BA", "BB", "BD", "BE", "BF", "BG", "BH", "BI", "BJ", "BL", "BM", "BN", "BO", "BQ", "BR", "BS", "BT", "BV", "BW", "BZ", "CA", "CC", "CG", "CH", "CI", "CK", "CL", "CM", "CN", "CO", "CR", "CV", "CW", "CX", "CY", "CZ", "DE", "DJ", "DK", "DM", "DO", "DZ", "EC", "EE", "EG", "EH", "ER", "ES", "ET", "FI", "FJ", "FK", "FM", "FO", "FR", "GA", "GB", "GD", "GE", "GF", "GG", "GH", "GI", "GL", "GM", "GN", "GP", "GQ", "GR", "GS", "GT", "GU", "GW", "GY", "HK", "HM", "HN", "HR", "HU", "ID", "IE", "IL", "IM", "IN", "IO", "IQ", "IS", "IT", "JE", "JM", "JO", "JP", "KE", "KG", "KH", "KI", "KM", "KN", "KR", "KW", "KY", "KZ", "LA", "LB", "LC", "LI", "LK", "LR", "LS", "LT", "LU", "LV", "MA", "MC", "MD", "ME", "MF", "MG", "MH", "MK", "MN", "MO", "MP", "MQ", "MR", "MS", "MT", "MU", "MV", "MW", "MX", "MY", "MZ", "NA", "NC", "NE", "NF", "NG", "NL", "NO", "NP", "NR", "NU", "NZ", "OM", "PA", "PE", "PF", "PG", "PH", "PK", "PL", "PM", "PN", "PR", "PS", "PT", "PW", "PY", "QA", "RE", "RO", "RS", "RW", "SA", "SB", "SC", "SE", "SG", "SH", "SI", "SJ", "SK", "SL", "SM", "SN", "SR", "ST", "SV", "SX", "SZ", "TC", "TD", "TF", "TG", "TH", "TJ", "TK", "TL", "TM", "TN", "TO", "TR", "TT", "TV", "TW", "TZ", "UA", "UG", "UM", "US", "UY", "UZ", "VA", "VC", "VG", "VI", "VN", "VU", "WF", "WS", "XK", "YT", "ZA", "ZM" ], "description": "Two-letter ISO 3166-1 alpha-2 representation of a supported country.", "x-enum-descriptions": { "AD": { "description": "Andorra" }, "AE": { "description": "United Arab Emirates" }, "AG": { "description": "Antigua and Barbuda" }, "AI": { "description": "Anguilla" }, "AL": { "description": "Albania" }, "AM": { "description": "Armenia" }, "AO": { "description": "Angola" }, "AR": { "description": "Argentina" }, "AS": { "description": "American Samoa" }, "AT": { "description": "Austria" }, "AU": { "description": "Australia" }, "AW": { "description": "Aruba" }, "AX": { "description": "Åland Islands" }, "AZ": { "description": "Azerbaijan" }, "BA": { "description": "Bosnia and Herzegovina" }, "BB": { "description": "Barbados" }, "BD": { "description": "Bangladesh" }, "BE": { "description": "Belgium" }, "BF": { "description": "Burkina Faso" }, "BG": { "description": "Bulgaria" }, "BH": { "description": "Bahrain" }, "BI": { "description": "Burundi" }, "BJ": { "description": "Benin" }, "BL": { "description": "Saint Barthélemy" }, "BM": { "description": "Bermuda" }, "BN": { "description": "Brunei" }, "BO": { "description": "Bolivia" }, "BQ": { "description": "Caribbean Netherlands (Bonaire, Sint Eustatius, and Saba)" }, "BR": { "description": "Brazil" }, "BS": { "description": "Bahamas" }, "BT": { "description": "Bhutan" }, "BV": { "description": "Bouvet Island" }, "BW": { "description": "Botswana" }, "BZ": { "description": "Belize" }, "CA": { "description": "Canada" }, "CC": { "description": "Cocos Islands" }, "CG": { "description": "Republic of Congo" }, "CH": { "description": "Switzerland" }, "CI": { "description": "Côte d'Ivoire (Ivory Coast)" }, "CK": { "description": "Cook Islands" }, "CL": { "description": "Chile" }, "CM": { "description": "Cameroon" }, "CN": { "description": "China" }, "CO": { "description": "Colombia" }, "CR": { "description": "Costa Rica" }, "CV": { "description": "Cape Verde" }, "CW": { "description": "Curaçao" }, "CX": { "description": "Christmas Island" }, "CY": { "description": "Cyprus" }, "CZ": { "description": "Czechia (Czech Republic)" }, "DE": { "description": "Germany" }, "DJ": { "description": "Djibouti" }, "DK": { "description": "Denmark" }, "DM": { "description": "Dominica" }, "DO": { "description": "Dominican Republic" }, "DZ": { "description": "Algeria" }, "EC": { "description": "Ecuador" }, "EE": { "description": "Estonia" }, "EG": { "description": "Egypt" }, "EH": { "description": "Western Sahara" }, "ER": { "description": "Eritrea" }, "ES": { "description": "Spain" }, "ET": { "description": "Ethiopia" }, "FI": { "description": "Finland" }, "FJ": { "description": "Fiji" }, "FK": { "description": "Falkland Islands" }, "FM": { "description": "Micronesia" }, "FO": { "description": "Faroe Islands" }, "FR": { "description": "France" }, "GA": { "description": "Gabon" }, "GB": { "description": "United Kingdom" }, "GD": { "description": "Grenada" }, "GE": { "description": "Georgia" }, "GF": { "description": "French Guiana" }, "GG": { "description": "Guernsey" }, "GH": { "description": "Ghana" }, "GI": { "description": "Gibraltar" }, "GL": { "description": "Greenland" }, "GM": { "description": "Gambia" }, "GN": { "description": "Guinea" }, "GP": { "description": "Guadeloupe" }, "GQ": { "description": "Equatorial Guinea" }, "GR": { "description": "Greece" }, "GS": { "description": "South Georgia and the South Sandwich Islands" }, "GT": { "description": "Guatemala" }, "GU": { "description": "Guam" }, "GW": { "description": "Guinea-Bissau" }, "GY": { "description": "Guyana" }, "HK": { "description": "Hong Kong" }, "HM": { "description": "Heard Island and McDonald Islands" }, "HN": { "description": "Honduras" }, "HR": { "description": "Croatia" }, "HU": { "description": "Hungary" }, "ID": { "description": "Indonesia" }, "IE": { "description": "Ireland" }, "IL": { "description": "Israel" }, "IM": { "description": "Isle of Man" }, "IN": { "description": "India" }, "IO": { "description": "British Indian Ocean Territory" }, "IQ": { "description": "Iraq" }, "IS": { "description": "Iceland" }, "IT": { "description": "Italy" }, "JE": { "description": "Jersey" }, "JM": { "description": "Jamaica" }, "JO": { "description": "Jordan" }, "JP": { "description": "Japan" }, "KE": { "description": "Kenya" }, "KG": { "description": "Kyrgyzstan" }, "KH": { "description": "Cambodia" }, "KI": { "description": "Kiribati" }, "KM": { "description": "Comoros" }, "KN": { "description": "Saint Kitts and Nevis" }, "KR": { "description": "South Korea" }, "KW": { "description": "Kuwait" }, "KY": { "description": "Cayman Islands" }, "KZ": { "description": "Kazakhstan" }, "LA": { "description": "Lao People's Democratic Republic (Laos)" }, "LB": { "description": "Lebanon" }, "LC": { "description": "Saint Lucia" }, "LI": { "description": "Liechtenstein" }, "LK": { "description": "Sri Lanka" }, "LR": { "description": "Liberia" }, "LS": { "description": "Lesotho" }, "LT": { "description": "Lithuania" }, "LU": { "description": "Luxembourg" }, "LV": { "description": "Latvia" }, "MA": { "description": "Morocco" }, "MC": { "description": "Monaco" }, "MD": { "description": "Moldova" }, "ME": { "description": "Montenegro" }, "MF": { "description": "Saint Martin" }, "MG": { "description": "Madagascar" }, "MH": { "description": "Marshall Islands" }, "MK": { "description": "Macedonia" }, "MN": { "description": "Mongolia" }, "MO": { "description": "Macao" }, "MP": { "description": "Northern Mariana Islands" }, "MQ": { "description": "Martinique" }, "MR": { "description": "Mauritania" }, "MS": { "description": "Montserrat" }, "MT": { "description": "Malta" }, "MU": { "description": "Mauritius" }, "MV": { "description": "Maldives" }, "MW": { "description": "Malawi" }, "MX": { "description": "Mexico" }, "MY": { "description": "Malaysia" }, "MZ": { "description": "Mozambique" }, "NA": { "description": "Namibia" }, "NC": { "description": "New Caledonia" }, "NE": { "description": "Niger" }, "NF": { "description": "Norfolk Island" }, "NG": { "description": "Nigeria" }, "NL": { "description": "Netherlands" }, "NO": { "description": "Norway" }, "NP": { "description": "Nepal" }, "NR": { "description": "Nauru" }, "NU": { "description": "Niue" }, "NZ": { "description": "New Zealand" }, "OM": { "description": "Oman" }, "PA": { "description": "Panama" }, "PE": { "description": "Peru" }, "PF": { "description": "French Polynesia" }, "PG": { "description": "Papua New Guinea" }, "PH": { "description": "Philippines" }, "PK": { "description": "Pakistan" }, "PL": { "description": "Poland" }, "PM": { "description": "Saint Pierre and Miquelon" }, "PN": { "description": "Pitcairn" }, "PR": { "description": "Puerto Rico" }, "PS": { "description": "Palestinian territories" }, "PT": { "description": "Portugal" }, "PW": { "description": "Palau" }, "PY": { "description": "Paraguay" }, "QA": { "description": "Qatar" }, "RE": { "description": "Reunion" }, "RO": { "description": "Romania" }, "RS": { "description": "Republic of Serbia" }, "RW": { "description": "Rwanda" }, "SA": { "description": "Saudi Arabia" }, "SB": { "description": "Solomon Islands" }, "SC": { "description": "Seychelles" }, "SE": { "description": "Sweden" }, "SG": { "description": "Singapore" }, "SH": { "description": "Saint Helena" }, "SI": { "description": "Slovenia" }, "SJ": { "description": "Svalbard and Jan Mayen" }, "SK": { "description": "Slovakia" }, "SL": { "description": "Sierra Leone" }, "SM": { "description": "San Marino" }, "SN": { "description": "Senegal" }, "SR": { "description": "Suriname" }, "ST": { "description": "São Tomé and Príncipe" }, "SV": { "description": "El Salvador" }, "SX": { "description": "Sint Maarten" }, "SZ": { "description": "Swaziland" }, "TC": { "description": "Turks and Caicos Islands" }, "TD": { "description": "Chad" }, "TF": { "description": "French Southern and Antarctic Lands" }, "TG": { "description": "Togo" }, "TH": { "description": "Thailand" }, "TJ": { "description": "Tajikistan" }, "TK": { "description": "Tokelau" }, "TL": { "description": "Timor-Leste" }, "TM": { "description": "Turkmenistan" }, "TN": { "description": "Tunisia" }, "TO": { "description": "Tonga" }, "TR": { "description": "Turkey" }, "TT": { "description": "Trinidad and Tobago" }, "TV": { "description": "Tuvalu" }, "TW": { "description": "Taiwan" }, "TZ": { "description": "Tanzania" }, "UA": { "description": "Ukraine" }, "UG": { "description": "Uganda" }, "UM": { "description": "United States Minor Outlying Islands" }, "US": { "description": "United States" }, "UY": { "description": "Uruguay" }, "UZ": { "description": "Uzbekistan" }, "VA": { "description": "Holy See (Vatican City)" }, "VC": { "description": "Saint Vincent and the Grenadines" }, "VG": { "description": "British Virgin Islands" }, "VI": { "description": "U.S. Virgin Islands" }, "VN": { "description": "Vietnam" }, "VU": { "description": "Vanuatu" }, "WF": { "description": "Wallis and Futuna" }, "WS": { "description": "Samoa" }, "XK": { "description": "Kosovo" }, "YT": { "description": "Mayotte" }, "ZA": { "description": "South Africa" }, "ZM": { "description": "Zambia" } } } ] }, "minItems": 1, "description": "Supported two-letter ISO 3166-1 alpha-2 country code. Customers located in the listed countries are charged the override price.", "uniqueItems": true }, "unit_price": { "properties": { "amount": { "type": "string", "description": "Amount in the lowest denomination for the currency, e.g. 10 USD = 1000 (cents). Although represented as a string, this value must be a valid integer." }, "currency_code": { "type": "string", "enum": [ "USD", "EUR", "GBP", "JPY", "AUD", "CAD", "CHF", "HKD", "SGD", "SEK", "ARS", "BRL", "CLP", "CNY", "COP", "CZK", "DKK", "HUF", "ILS", "INR", "KRW", "MXN", "NOK", "NZD", "PEN", "PLN", "RUB", "THB", "TRY", "TWD", "UAH", "VND", "ZAR" ], "description": "Supported three-letter ISO 4217 currency code.", "title": "Currency code", "x-enum-descriptions": { "USD": { "description": "United States Dollar" }, "EUR": { "description": "Euro" }, "GBP": { "description": "Pound Sterling" }, "JPY": { "description": "Japanese Yen" }, "AUD": { "description": "Australian Dollar" }, "CAD": { "description": "Canadian Dollar" }, "CHF": { "description": "Swiss Franc" }, "HKD": { "description": "Hong Kong Dollar" }, "SGD": { "description": "Singapore Dollar" }, "SEK": { "description": "Swedish Krona" }, "ARS": { "description": "Argentine Peso" }, "BRL": { "description": "Brazilian Real" }, "CLP": { "description": "Chilean Peso" }, "CNY": { "description": "Chinese Yuan" }, "COP": { "description": "Colombian Peso" }, "CZK": { "description": "Czech Koruna" }, "DKK": { "description": "Danish Krone" }, "HUF": { "description": "Hungarian Forint" }, "ILS": { "description": "Israeli Shekel" }, "INR": { "description": "Indian Rupee" }, "KRW": { "description": "South Korean Won" }, "MXN": { "description": "Mexican Peso" }, "NOK": { "description": "Norwegian Krone" }, "NZD": { "description": "New Zealand Dollar" }, "PEN": { "description": "Peruvian Sol" }, "PLN": { "description": "Polish Zloty" }, "RUB": { "description": "Russian Ruble" }, "THB": { "description": "Thai Baht" }, "TRY": { "description": "Turkish Lira" }, "TWD": { "description": "New Taiwan Dollar" }, "UAH": { "description": "Ukrainian Hryvnia" }, "VND": { "description": "Vietnamese Dong" }, "ZAR": { "description": "South African Rand" } } } }, "required": [ "amount", "currency_code" ], "type": "object", "description": "Override price. This price applies to customers located in the countries for this unit price override.", "title": "Money" } }, "title": "Unit price override", "additionalProperties": false }, "maxItems": 250, "description": "List of unit price overrides. Use to override the base price with a custom price and currency for a country or group of countries." }, "quantity": { "properties": { "minimum": { "type": "integer", "minimum": 1, "maximum": 999999999, "description": "Minimum quantity of the product related to this price that can be bought. Required if `maximum` set.", "examples": [ 1 ], "default": 1 }, "maximum": { "type": "integer", "minimum": 1, "maximum": 999999999, "description": "Maximum quantity of the product related to this price that can be bought. Required if `minimum` set. Must be greater than or equal to the `minimum` value.", "examples": [ 100 ], "default": 100 } }, "required": [ "minimum", "maximum" ], "type": "object", "title": "price_quantity", "examples": [ { "minimum": 1, "maximum": 100 } ], "description": "Limits on how many times the related product can be purchased at this price. Useful for discount campaigns." }, "status": { "type": "string", "enum": [ "active", "archived" ], "description": "Whether this entity can be used in Paddle.", "title": "Status", "x-enum-descriptions": { "active": { "description": "Entity is active and can be used." }, "archived": { "description": "Entity is archived, so can't be used." } } }, "custom_data": { "anyOf": [ { "type": "object", "unevaluatedProperties": {}, "description": "Your own structured key-value data.", "title": "Custom Data", "example": { "customer_reference_id": "abcd1234" } }, { "type": "null" } ], "description": "Your own structured key-value data." }, "import_meta": { "anyOf": [ { "type": "object", "required": [ "imported_from" ], "properties": { "external_id": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 200, "description": "Reference or identifier for this entity from the provider where it was imported from.", "title": "External ID", "examples": [ "9b95b0b8-e10f-441a-862e-1936a6d818ab" ] }, { "type": "null" } ] }, "imported_from": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Name of the platform or provider where this entity was imported from.", "examples": [ "paddle_classic" ] } }, "description": "Import information for this entity. `null` if this entity is not imported.", "title": "ImportMeta" }, { "type": "null" } ], "description": "Import information for this entity. `null` if this entity is not imported." }, "created_at": { "anyOf": [ { "type": "string", "format": "date-time", "description": "RFC 3339 datetime string of when this entity was created. Set automatically by Paddle.", "title": "Created at", "examples": [ "2024-10-12T07:20:50.52Z" ] }, { "type": "null" } ] }, "updated_at": { "anyOf": [ { "type": "string", "format": "date-time", "description": "RFC 3339 datetime string of when this entity was updated. Set automatically by Paddle.", "title": "Updated at", "examples": [ "2024-10-13T07:20:50.52Z" ] }, { "type": "null" } ] } }, "required": [ "id", "product_id", "description", "type", "name", "billing_cycle", "trial_period", "tax_mode", "unit_price", "unit_price_overrides", "quantity", "status", "custom_data", "import_meta", "created_at", "updated_at" ], "type": "object", "description": "New or changed entity." } } } ``` ## Example ```json { "event_id": "evt_01hv0vaxeypbdcfw039a3gmc78", "event_type": "price.created", "occurred_at": "2024-04-09T07:14:38.686498Z", "notification_id": "ntf_01hv0vaxj3znpd9vdpp3efa4n4", "data": { "id": "pri_01hv0vax6rv18t4tamj848ne4d", "name": "Monthly (per seat)", "type": "standard", "status": "active", "quantity": { "maximum": 100, "minimum": 1 }, "tax_mode": "account_setting", "product_id": "pro_01htz88xpr0mm7b3ta2pjkr7w2", "unit_price": { "amount": "500", "currency_code": "USD" }, "custom_data": null, "description": "Monthly (per seat) with 14 day trial", "import_meta": null, "trial_period": { "interval": "day", "frequency": 14, "requires_payment_method": false }, "billing_cycle": { "interval": "month", "frequency": 1 }, "unit_price_overrides": [], "created_at": "2024-04-09T07:14:38.424504286Z", "updated_at": "2024-04-09T07:14:38.424504359Z" } } ```