# Create a price for a product

Creates a new price for an existing product. The price can be one-time or recurring (subscription-based).

Endpoint: POST /prices/{id}
Version: 1.0

## Path parameters:

  - `id` (string, required)
    Unique identifier of the product to add the price to
    Example: "prod_xT4LfvxLMQb4s9uFNIbXf9pm"

## Header parameters:

  - `cc-api-key` (string, required)
    Chaching API Key

## Request fields (application/json):

  - `currency` (string, required)
    Three-letter ISO currency code
    Enum: "USD"

  - `description` (string)
    Customer-facing price description
    Example: "Premium Plan - Monthly"

  - `recurring` (object,null)
    Recurring components of the price

  - `recurring.interval` (string, required)
    Billing frequency
    Enum: "day", "week", "month", "year"

  - `recurring.interval_count` (number, required)
    Number of intervals between billings
    Example: 1

  - `tax_behavior` (string, required)
    Tax calculation behavior
    Enum: "exclusive", "inclusive"

  - `type` (string, required)
    Price type
    Enum: "recurring", "one_time"

  - `unit_amount` (number, required)
    Unit amount in cents
    Example: 1000

## Response 201 fields (application/json):

  - `id` (string, required)
    Unique identifier for the object.
    Example: "price_1SGKTmDZYOQH9uHk1vaSxPKa"

  - `object` (string, required)
    String representing the object’s type.
    Enum: "price"

  - `active` (boolean, required)
    Indicates whether the object is active.
    Example: true

  - `created` (number, required)
    Time at which the object was created. Measured in seconds since the Unix epoch
    Example: 1760018761

  - `currency` (string, required)
    Three-letter ISO currency code, in uppercase
    Example: "USD"

  - `description` (string,null)
    Customer-facing price description
    Example: "Premium Plan - Monthly"

  - `product` (string, required)
    ID of the product this price is associated with

  - `recurring` (object,null, required)
    The recurring components of a price such as interval and interval_count. Null if the price is not recurring.
    Example: {"interval":"month","interval_count":1}

  - `recurring.interval` (string, required)
    Billing frequency
    Enum: "day", "week", "month", "year"

  - `recurring.interval_count` (number, required)
    Number of intervals between billings
    Example: 1

  - `tax_behavior` (string, required)
    The tax behavior of the product.
    Enum: "exclusive", "inclusive"

  - `type` (string, required)
    One of one_time or recurring depending on whether the price is for a one-time purchase or a recurring (subscription) purchase.
    Enum: "recurring", "one_time"

  - `unit_amount` (number,null, required)
    The unit amount in cents to be charged, represented as a whole integer if possible.
    Example: 1000

  - `unit_amount_decimal` (string,null, required)
    Same as unit_amount
    Example: "1000"

  - `link` (string,null)
    Payment link associated with the price for hosted pages or other off-session payments.


## Response 400 fields

## Response 404 fields