Update Currencies

Purpose

To update currency details.

Request URL

To update home currency:
https://www.zohoapis.com/crm/v2/org/currencies

To update currencies other than home currency:
https://www.zohoapis.com/crm/v2/org/currencies/actions/enable

Request Method

PUT

Scope

scope=ZohoCRM.settings.currencies.{operation_type}

Possible operation types
UPDATE - Update currencies data
Note:

The name and ISO code of the currencies are defined and cannot be updated.

Request JSON

AttributeData TypeMandatoryDescription
decimal_separatorStringYesThe decimal separator separates the integer part of the currency from its fractional part. It can be a Period or Comma, depending on the currency.
thousand_separatorStringYesThe thousand separator separates groups of thousands in a currency. It can be a Period, Comma, or Space, depending on the currency.
decimal_placesIntegerYesRepresents the number of decimal places allowed for the currency. It can be 0, 2, or 3.
prefix_symbolBooleanNoRepresents the position of the ISO code in the currency.
true: Display ISO code before the currency value.
false: Display ISO code after the currency value.
nameStringYesRepresents the name of the currency.
iso_codeStringYesRepresents the ISO code of the currency.
symbolStringYesRepresents the symbol of the currency.
exchange_rateStringYesRepresents the rate at which the currency has to be exchanged for home currency.
is_activeBooleanNoRepresents the status of the currency.
true: The currency is active.
false: The currency is inactive.

Possible Errors

HTTP StatusError CodeMessageReason
404INVALID_URL_PATTERNPlease check if the URL trying to access is a correct oneThe request URL has syntactical errors.
400INVALID_DATAID is invalidYou have specified an invalid currency ID
400INVALID_DATACurrency symbol is invalid.You have specified an invalid currency symbol.
403FEATURE_NOT_SUPPORTEDThe multi-currency feature is not available except the Enterprise and higher editions.The multi-currency feature is only available in Enterprise and Ultimate editions.
403FEATURE_NOT_ENABLEDThe multi-currency feature is not enabled.You can update currencies only after enabling the multi-currency feature. Refer to Enable Multi-Currency.
400NOT_ALLOWEDThousand separator and decimal separator should not be equalSpecify different separators for thousands and decimals.
400NOT_ALLOWEDBase currency ID is not allowed hereYou cannot update the base currency values.

Sample Request To Update Home Currency

Copiedcurl "https://www.zohoapis.com/crm/v2/org/currencies/actions/enable"
-X PUT
-d input.json
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"