Skip to navigation
API ReferenceInbound to Gappify6. Fx Rates

Create a new or update existing Fx Rates entries.

GA

Create a new or update existing FX Rates entries with the provided data.

Required Fields Summary

FieldTypeDescription
source_system_idstringERP id which uniquely represents the specific FX rate value
perioddateFX rate applicable period.
⚠️ Required format: yyyy-mm-01
from_currencystringThe currency being converted from (ISO code)
to_currencystringThe currency being converted to (ISO code)
ratedoubleFX rate value (limit to 5 decimal places)

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects a list of objects.
source_system_idstringRequired
ERP id which uniquely represents the specific fx rate value. This value will be used to match source data and perform upserts.
perioddateRequired

FX rate applicable period.
Format: yyyy-mm-01 (e.g., 2026-03-01).

from_currencystringRequired

The currency being converted from. The value should match the g_name of the currency in source_coas. Use the ISO code of the currency.

to_currencystringRequired

The currency being converted to. The value should match the g_name of the currency in source_coas. Use the ISO code of the currency.

ratedoubleRequired
FX rate value. Limit to 5 decimal places.

Response

This endpoint returns an object.
request_idUUID
Unique identifier for the request
status"IN_PROGRESS"
Status of the request

Errors

401
Unauthorized Error
404
Not Found Error
422
Unprocessable Entity Error
500
Internal Server Error