---
title: "Create Currency Exchange Configuration"
method: POST
path: "/v1/currency_exchange_configuration/create"
tags: ["CurrencyExchangeConfiguration"]
---

# Create Currency Exchange Configuration

`POST /v1/currency_exchange_configuration/create`

Create Currency Exchange Configuration.

## Request body

- CurrencyExchangeConfigurationDefinition
  - `sysId` string — ID of the Currency Configuration component
  - `created_at` string, date-time — Created datetime for the component
  - `updated_at` string, date-time — Updated datetime for the component
  - `created_by` string — Created by user name
  - `updated_by` string — Updated by user name
  - `master_account_id` string — Master account ID
  - `tenant_ids` string[]
  - `name` string, required — Name of Currency Exchange Configuration
  - `description` string — Description of Currency Exchange Configuration
  - `configurations` CurrencyRateConfiguration[], required — Configured Currency Exchange Configuration
    - `currency_rate` ExchangeCurrencyRate[], required — Currency Rate of Currency Exchange Configuration
      - `source_currency` 'AED' | 'ALL' | 'ARS' | 'AUD' | 'BAM' | 'BDT' | 'BGN' | 'BHD' | 'BRL' | 'CAD' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CZK' | 'DKK' | 'EGP' | 'EUR' | 'GBP' | 'HKD' | 'HRK' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'ISK' | 'JPY' | 'KES' | 'KRW' | 'KWD' | 'KZT' | 'MOP' | 'MVR' | 'MXN' | 'MYR' | 'NOK' | 'NZD' | 'OMR' | 'PEN' | 'PHP' | 'PKR' | 'PLN' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'SAR' | 'SEK' | 'SGD' | 'THB' | 'TRY' | 'TWD' | 'USD' | 'VND' | 'ZAR', required — Source Currency for Exchange Configuration
      - `exchange_rate` number, required — Exchange Rate of Currency Exchange Configuration
    - `start_date` string, date-time, required — Start date of the Currency Exchange Configuration
    - `end_date` string, date-time — End date of the Currency Exchange Configuration
  - `conversion_type` 'CustomExchangeRate' | 'DynamicExchangeRate' | 'CsvFileCustomExchangeRate', required — Conversion type of currency exchange configuration.
  - `target_currency` 'AED' | 'ALL' | 'ARS' | 'AUD' | 'BAM' | 'BDT' | 'BGN' | 'BHD' | 'BRL' | 'CAD' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CZK' | 'DKK' | 'EGP' | 'EUR' | 'GBP' | 'HKD' | 'HRK' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'ISK' | 'JPY' | 'KES' | 'KRW' | 'KWD' | 'KZT' | 'MOP' | 'MVR' | 'MXN' | 'MYR' | 'NOK' | 'NZD' | 'OMR' | 'PEN' | 'PHP' | 'PKR' | 'PLN' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'SAR' | 'SEK' | 'SGD' | 'THB' | 'TRY' | 'TWD' | 'USD' | 'VND' | 'ZAR', required — Target Currency for Exchange Configuration
  - `is_enabled` boolean, required — Is currency exchange enabled
  - `scope` 'Account' | 'Tenant', required — Scope of currency exchange configuration.

## Response `200`

Created successfully

- CurrencyExchangeConfigurationDefinition
  - `sysId` string — ID of the Currency Configuration component
  - `created_at` string, date-time — Created datetime for the component
  - `updated_at` string, date-time — Updated datetime for the component
  - `created_by` string — Created by user name
  - `updated_by` string — Updated by user name
  - `master_account_id` string — Master account ID
  - `tenant_ids` string[]
  - `name` string, required — Name of Currency Exchange Configuration
  - `description` string — Description of Currency Exchange Configuration
  - `configurations` CurrencyRateConfiguration[], required — Configured Currency Exchange Configuration
    - `currency_rate` ExchangeCurrencyRate[], required — Currency Rate of Currency Exchange Configuration
      - `source_currency` 'AED' | 'ALL' | 'ARS' | 'AUD' | 'BAM' | 'BDT' | 'BGN' | 'BHD' | 'BRL' | 'CAD' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CZK' | 'DKK' | 'EGP' | 'EUR' | 'GBP' | 'HKD' | 'HRK' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'ISK' | 'JPY' | 'KES' | 'KRW' | 'KWD' | 'KZT' | 'MOP' | 'MVR' | 'MXN' | 'MYR' | 'NOK' | 'NZD' | 'OMR' | 'PEN' | 'PHP' | 'PKR' | 'PLN' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'SAR' | 'SEK' | 'SGD' | 'THB' | 'TRY' | 'TWD' | 'USD' | 'VND' | 'ZAR', required — Source Currency for Exchange Configuration
      - `exchange_rate` number, required — Exchange Rate of Currency Exchange Configuration
    - `start_date` string, date-time, required — Start date of the Currency Exchange Configuration
    - `end_date` string, date-time — End date of the Currency Exchange Configuration
  - `conversion_type` 'CustomExchangeRate' | 'DynamicExchangeRate' | 'CsvFileCustomExchangeRate', required — Conversion type of currency exchange configuration.
  - `target_currency` 'AED' | 'ALL' | 'ARS' | 'AUD' | 'BAM' | 'BDT' | 'BGN' | 'BHD' | 'BRL' | 'CAD' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CZK' | 'DKK' | 'EGP' | 'EUR' | 'GBP' | 'HKD' | 'HRK' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'ISK' | 'JPY' | 'KES' | 'KRW' | 'KWD' | 'KZT' | 'MOP' | 'MVR' | 'MXN' | 'MYR' | 'NOK' | 'NZD' | 'OMR' | 'PEN' | 'PHP' | 'PKR' | 'PLN' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'SAR' | 'SEK' | 'SGD' | 'THB' | 'TRY' | 'TWD' | 'USD' | 'VND' | 'ZAR', required — Target Currency for Exchange Configuration
  - `is_enabled` boolean, required — Is currency exchange enabled
  - `scope` 'Account' | 'Tenant', required — Scope of currency exchange configuration.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.dev/corestack/apis/corestack-external-api.md) · [All operations](https://skmtc.dev/corestack/apis/corestack-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corestack/corestack-external-api/revisions/bf2cdf20826d/schema)