[POST] .../v1/currency/add
Creates a new currency. Use this method to create a currency before it is used by accounts, price lists, documents or exchange-rate workflows. It creates one currency and returns new_id after validating code_num, code_chr and name; code_num must be positive and name must not be empty. The caller must have currency add permission; missing body, missing required fields, duplicate code or name, denied access and storage validation errors are returned as HTTP 200 ErrorResult business errors.
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| code_chr | String | Required | Currency alphabetic code. |
| code_num | Int64 | Required | Currency numeric code. |
| name | String | Required | Currency name. |
Request Example
{
"code_num": 840,
"code_chr": "USD",
"name": "US dollar"
}Response Parameters
| Name | Type | Description |
|---|---|---|
| ok | Boolean | Indicates whether the request completed successfully. |
| result | Insert | Created record result. |
Response Example
{
"ok": true,
"result": {
"new_id": 840
}
}