Skip to content

Create Currency

Adds a new currency to the store. code and name are required; the formatting fields (symbol, decimal, groupSeparator, decimalSeparator, currencyPosition) are optional.

Operation

OperationTypePurpose
createAdminSettingsCurrency(input:)MutationCreate a currency

Input fields

FieldRequiredMeaning
codeyes3-letter ISO code; stored uppercase; must be unique.
nameyesDisplay name.
symbolnoSymbol prefixed/suffixed to amounts (e.g. $).
decimalnoNumber of decimal places.
groupSeparatornoThousands separator (e.g. ,).
decimalSeparatornoDecimal point character (e.g. .).
currencyPositionnoleft or right — where the symbol sits relative to the amount.

Notes

  • A duplicate code is rejected with "The code has already been taken."
  • Permission: settings.currencies.create.

All currency operations require an admin Bearer token — see Authentication.

Released under the MIT License.