Create currencies

POST/org/currencies

Use it in a workflow

Add a step and choose the Zoho CRM connector.
Pick the Create currencies action (under Organisation).
Fill in the fields below, then reference the result from later steps as {{createCurrencies.response.data}}.

Request

Request body

Enter the body as JSON in the step's Body field.

currenciesarray<object>required

List of currencies to add to the organization. Supports up to 180 currencies per request.

formatobject4 fields

Represents the format of the base currency with details like decimal_separator, thousand_separator, and decimal_places.

exchange_ratestringrequired

Represents the rate at which the currency has to be exchanged with home currency. Accepts positive decimal numbers up to **nine** digits and nine decimal places. Example: 123456789.123456789.

is_activeboolean

Indicates whether the currency is active. **Possible Values:** **true** - The currency is active. This is the default value. **false** - The currency is inactive.

exchange_rate_auto_updateboolean

Indicates whether the currency has the automated exchange rate option enabled or not.

iso_codestringrequired

Represents the ISO code of the currency. You can get the currency code from the CRM UI at **Setup > General > Company Settings > Currencies.**

symbolstring

Indicates the currency symbol used for display.

namestring

Represents the name of the currency. You can get the available currencies from the CRM UI at **Setup > General > Company Settings > Currencies.**

json

{
  "currencies": [
    {
      "exchange_rate": "string",
      "iso_code": "string",
      "format": {
        "numeral_system": "International",
        "decimal_places": "0",
        "decimal_separator": "Comma",
        "thousand_separator": "Comma"
      },
      "is_active": false,
      "exchange_rate_auto_update": false,
      "symbol": "string",
      "name": "string"
    }
  ]
}

Response

Returns 200 with an object. Read it in later steps with {{createCurrencies.response.data.<field>}}.

currenciesarray<object>

List of results for each currency creation attempt. Returns one entry per submitted currency.

codestringrequired

The code representing success

One ofSUCCESS

messagestringrequired

Success message for the operation result.

detailsobjectrequired1 fields

Contains currency identifier.

statusstringrequired

Indicates the status of the operation.

One ofsuccess

json

{
  "currencies": [
    {
      "code": "SUCCESS",
      "message": "string",
      "details": {
        "id": "string"
      },
      "status": "success"
    }
  ]
}

Need more? See the Zoho CRM guide for connection setup and behaviour shared by every action.

Was this page helpful?