---
title: "Create price unit"
method: POST
path: "/prices/units"
tags: ["Price Units"]
---

# Create price unit

`POST /prices/units`

Use when defining a new unit of measure for pricing (e.g. GB, API call, seat). Ideal for metered or usage-based prices.

## Request body

- CreatePriceUnitRequest
  - `base_currency` string, required — base_currency is the currency that the price unit is based on
  - `code` string, required
  - `conversion_rate` string, required — ConversionRate defines the exchange rate from this price unit to the base currency. This rate is used to convert amounts in the custom price unit to the base currency for storage and billing. Conversion formula: price_unit_amount * conversion_rate = base_currency_amount Example: If conversion_rate = "0.01" and base_currency = "usd": 100 price_unit tokens * 0.01 = 1.00 USD Note: Rounding precision is determined by the base currency (e.g., USD uses 2 decimal places, JPY uses 0).
  - `metadata` TypesMetadata
  - `name` string, required
  - `symbol` string, required

## Response `201`

Created

- CreatePriceUnitResponse
  - `base_currency` string
  - `code` string
  - `conversion_rate` string
  - `created_at` string, date-time
  - `created_by` string
  - `environment_id` string
  - `id` string
  - `metadata` TypesMetadata
  - `name` string
  - `status` 'published' | 'deleted' | 'archived'
  - `symbol` string
  - `tenant_id` string
  - `updated_at` string, date-time
  - `updated_by` string

## Other responses

- `400` — Invalid request
- `500` — Server error

---

[API](https://skmtc.net/flexprice/apis/flexprice-api.md) · [All operations](https://skmtc.net/flexprice/apis/flexprice-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/flexprice/flexprice-api/versions/f0601ed97bd3/schema)