---
title: "Store a new currency"
method: POST
path: "/v1/currencies"
tags: ["currencies"]
---

# Store a new currency

`POST /v1/currencies`

Creates a new currency. The data required can be submitted as a JSON body or as a list of parameters.

## Headers

- `X-Trace-Id` string, uuid

## Request body

- CurrencyStore
  - `enabled` boolean — Defaults to true
  - `primary` boolean — Make this currency the primary currency for the current administration. You can set this value to FALSE, in which case nothing will change to the primary currency. If you set it to TRUE, the current primary currency will no longer be the primary currency.
  - `code` string, string, required
  - `name` string, string, required
  - `symbol` string, string, required
  - `decimal_places` integer — Supports 0-16 decimals.

## Response `200`

New currency stored, result in response.

## Other responses

- `400` — Bad request
- `401` — Unauthenticated
- `404` — Page not found
- `422` — Validation error. The body will have the exact details.
- `500` — Internal exception

---

[API](https://skmtc.dev/firefly-iii/apis/firefly-iii-api-develop.md) · [All operations](https://skmtc.dev/firefly-iii/apis/firefly-iii-api-develop/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/firefly-iii/firefly-iii-api-develop/revisions/8a1f6472e04b/schema)