---
title: "Create dimension conversion rate mapping"
method: POST
path: "/currencies/rates/dimension-mappings"
tags: ["Currencies"]
---

# Create dimension conversion rate mapping

`POST /currencies/rates/dimension-mappings`

Create a new dimension conversion rate mapping. This object creation may trigger the deletion of other existing mappings if the new object's fields would cause a conflict with those mappings. Will result in a response of 409 (Conflict), and require an additional query parameter `confirm=true` in the request to proceed with creating the mapping and deleting the existing mappings that conflict.Clients that receive a 200 OK response for an create should subsequently request the mappings list to learn of any deletions.

## Headers

- `HTTP_ACCEPT` string, required
- `X-Company-ID` string, required

## Request body

- DimensionExchangeRateTypeMapping
  - `id` integer, required
  - `account` integer, required
  - `is_default` boolean
  - `rate_type` string, required
  - `exchange_rate_type` integer, required
  - `from_currency` integer, nullable
  - `to_currency` integer, nullable
  - `constant_rate` string, decimal, nullable
  - `content_type_id` integer, required — A helper property method for grabbing the id of the ContentType of this model. This is used for creating the rateable relationships with ConversionRate instances. Returns: an integer representing the content type
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, required

## Response `201`

- DimensionExchangeRateTypeMapping
  - `id` integer, required
  - `account` integer, required
  - `is_default` boolean
  - `rate_type` string, required
  - `exchange_rate_type` integer, required
  - `from_currency` integer, nullable
  - `to_currency` integer, nullable
  - `constant_rate` string, decimal, nullable
  - `content_type_id` integer, required — A helper property method for grabbing the id of the ContentType of this model. This is used for creating the rateable relationships with ConversionRate instances. Returns: an integer representing the content type
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, required

---

[API](https://skmtc.net/cubesoftware/apis/cube-api.md) · [All operations](https://skmtc.net/cubesoftware/apis/cube-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cubesoftware/cube-api/revisions/67d9f45bb99b/schema)