---
title: "Create a price for a product"
method: POST
path: "/v2/products/{productId}/price"
tags: ["Products"]
---

# Create a price for a product

`POST /v2/products/{productId}/price`

## Request

- Base URL: `https://api.breeze.cash`
- URL: `https://api.breeze.cash/v2/products/{productId}/price`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/breeze/apis/breeze-api/docs/v2/products/:productId/price/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `productId` string, required

## Request body

- CreateProductPriceRequest: Price details
  - `currency` 'USD' | 'AUD' | 'CAD' | 'CHF' | 'DKK' | 'EUR' | 'GBP' | 'HKD' | 'JPY' | 'NOK' | 'NZD' | 'PLN' | 'SEK' | 'SGD' | 'TWD' | 'KRW', required
  - `amount` string
  - `unitAmount` integer: Positive minor units / cents (e.g., currency: "USD", unitAmount: 10000 = USD 100). Mutually exclusive with amount.
  - `type` 'ONE_TIME' | 'RECURRING', required
  - `billingCycleConfig` object
    - `interval` 'hour' | 'day' | 'week' | 'month' | 'year', required
    - `frequency` integer, required

## Response `200`

Success

- object: The created price
  - `status` 'SUCCEEDED', required
  - `data` CreateProductPriceResponse, required
    - `id` string
    - `createdAt` number
    - `updatedAt` number
    - `currency` 'USD' | 'AUD' | 'CAD' | 'CHF' | 'DKK' | 'EUR' | 'GBP' | 'HKD' | 'JPY' | 'NOK' | 'NZD' | 'PLN' | 'SEK' | 'SGD' | 'TWD' | 'KRW', required
    - `amountStr` string, required
    - `status` 'ACTIVE' | 'INACTIVE' | 'DELETED', required
    - `productId` string, required
    - `type` 'ONE_TIME' | 'RECURRING', required
    - `livemode` boolean, required
    - `billingCycleConfig` object
      - `interval` 'hour' | 'day' | 'week' | 'month' | 'year', required
      - `frequency` number, required
    - `unitAmount` number, required

## Other responses

- `400`: Bad request
- `401`: Unauthorized

---

[API](https://skmtc.dev/breeze/apis/breeze-api.md) - [All operations](https://skmtc.dev/breeze/apis/breeze-api/llms.txt) - [OpenAPI document](https://skmtc.dev/breeze/apis/breeze-api/revisions/4af083d182a6?raw)