---
title: "Create an FX rate"
method: POST
path: "/forex"
tags: ["FX Rates"]
---

# Create an FX rate

`POST /forex`

## Request

- Base URL: `https://us.api.flexprice.io/v1`
- URL: `https://us.api.flexprice.io/v1/forex`
- Auth: API key in header `x-api-key`

Configure a fixed exchange rate at tenant, customer or subscription scope. Overrides need a tenant rate for the same pair.

## Request body

- CreateFXRateRequest
  - `end_date` string, date-time
  - `from_currency` string, required
  - `metadata` object
  - `rate` string
  - `scope` 'tenant' | 'customer' | 'subscription', required
  - `scope_id` string
  - `source` 'fixed' | 'market'
  - `start_date` string, date-time
  - `to_currency` string, required

## Response `201`

Created

- FXRateResponse
  - `created_at` string, date-time
  - `created_by` string
  - `end_date` string, date-time
  - `environment_id` string
  - `from_currency` string
  - `id` string
  - `metadata` object
  - `rate` string
  - `scope` 'tenant' | 'customer' | 'subscription'
  - `scope_id` string
  - `source` 'fixed' | 'market'
  - `start_date` string, date-time
  - `status` 'published' | 'deleted' | 'archived'
  - `tenant_id` string
  - `to_currency` string
  - `updated_at` string, date-time
  - `updated_by` string

## Other responses

- `400`: Invalid request
- `500`: Server error

## Changes

- **2026-10-02** `dba33efc3068`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/flexprice/apis/flexprice-api/changes/forex/post.md)

---

[API](https://skmtc.dev/flexprice/apis/flexprice-api.md) - [All operations](https://skmtc.dev/flexprice/apis/flexprice-api/llms.txt) - [OpenAPI document](https://skmtc.dev/flexprice/apis/flexprice-api/revisions/84cb4a3af400?raw)