create_price
Set product prices optimized for global markets using country-specific overrides. Adjust pricing based on purchasing power parity, local currencies, and economic conditions to maximize conversion rates.
Instructions
This tool will create a new price for a product in Paddle.
When using unitPriceOverrides:
Group countries based on purchasing power parity (PPP), not just currency zones
Create separate overrides for countries with different economic conditions even if they share the same currency (e.g., Greece and Ireland should have different price points)
Adjust prices relative to local economic conditions - higher in wealthy markets, lower in developing economies
For optimal conversion rates, set prices using local market research and willingness-to-pay data
Use local currencies where preferred by the customer
Example unitPriceOverrides structure: [ { "countryCodes": ["GB"], "unitPrice": { "amount": "8500", "currencyCode": "GBP" } }, { "countryCodes": ["IE"], "unitPrice": { "amount": "9500", "currencyCode": "EUR" } }, { "countryCodes": ["GR"], "unitPrice": { "amount": "6500", "currencyCode": "EUR" } }, { "countryCodes": ["IN"], "unitPrice": { "amount": "30000", "currencyCode": "INR" } }, { "countryCodes": ["CN"], "unitPrice": { "amount": "20000", "currencyCode": "CNY" } } ]
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| billingCycle | No | For subscription prices, defines the recurring billing period | |
| customData | No | A JSON object of custom metadata. Limited to 50 keys, with key names up to 40 characters | |
| description | Yes | A description of this price that will be displayed to customers | |
| name | No | The name of the price | |
| productId | Yes | The ID of the product this price is for | |
| quantity | No | Quantity limits for this price | |
| trialPeriod | No | For subscription prices with a trial, defines the trial period duration | |
| unitPrice | Yes | The base price details | |
| unitPriceOverrides | No | Country-specific price overrides. Used for regional pricing |
Implementation Reference
- src/functions.ts:91-98 (handler)The handler function that executes the core logic of the 'create_price' tool by calling paddle.prices.create(params).export const createPrice = async (paddle: Paddle, params: z.infer<typeof Parameters.createPriceParameters>) => { try { const price = await paddle.prices.create(params); return price; } catch (error) { return error; } };
- src/tools.ts:82-93 (schema)Tool schema definition including method name, description, Zod parameters schema reference, and required actions.{ method: "create_price", name: "Create a price", description: prompts.createPricePrompt, parameters: params.createPriceParameters, actions: { prices: { write: true, create: true, }, }, },
- src/api.ts:15-15 (registration)Registration of the createPrice handler function in the toolMap under the CREATE_PRICE key.[TOOL_METHODS.CREATE_PRICE]: funcs.createPrice,
- src/constants.ts:7-7 (helper)Constant definition for the CREATE_PRICE tool method string used in registration and tool definitions.CREATE_PRICE: "create_price",