---
title: "Create custom currency"
method: POST
path: "/openmeter/currencies/custom"
tags: ["OpenMeter Billing"]
---

# Create custom currency

`POST /openmeter/currencies/custom`

Create a custom currency. This operation allows defining your own custom
currency for billing purposes.

## Request body

- CreateCurrencyCustomRequest — CurrencyCustom create request.
  - `name` string, required — The name of the currency. It should be a human-readable string that represents the name of the currency, such as "US Dollar" or "Euro".
  - `description` string — Description of the currency.
  - `symbol` string — The symbol of the currency. It should be a string that represents the symbol of the currency, such as "$" for US Dollar or "€" for Euro.
  - `code` string, required — Custom currency code. It should be a unique code but not conflicting with any existing fiat currency codes.

## Response `201`

CurrencyCustom created response.

- BillingCurrencyCustom — Describes custom currency.
  - `id` string, required — ULID (Universally Unique Lexicographically Sortable Identifier).
  - `type` 'custom', required — The type of the currency.
  - `name` string, required — The name of the currency. It should be a human-readable string that represents the name of the currency, such as "US Dollar" or "Euro".
  - `description` string — Description of the currency.
  - `symbol` string — The symbol of the currency. It should be a string that represents the symbol of the currency, such as "$" for US Dollar or "€" for Euro.
  - `code` string, required — Custom currency code. It should be a unique code but not conflicting with any existing fiat currency codes.
  - `created_at` string, date-time, required — [RFC3339](https://tools.ietf.org/html/rfc3339) formatted date-time string in UTC.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

## Changes

- **2026-05-11** (v3) `9d0042cb3815` — 4 info
  - api tag `OpenMeter Billing` added
  - api tag `OpenMeter Currencies` removed
  - added the new optional request property `description`
  - added the optional property `description` to the response with the `201` status

[Change history](https://skmtc.dev/openmeterio/apis/openmeter-api/changes/openmeter/currencies/custom/post.md)

---

[API](https://skmtc.dev/openmeterio/apis/openmeter-api.md) · [All operations](https://skmtc.dev/openmeterio/apis/openmeter-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openmeterio/openmeter-api/revisions/3ecbdfd707eb/schema)