NetSuite REST icon

NetSuite REST

Call NetSuite SuiteTalk REST operations.

Actions979

Currency → Insert or update record

AI-generated

Summary

Update or create a NetSuite Currency record by providing its ID and optional properties, including custom fields.

Inputs

  • isDebugMode — Include full request and response details in the output when true.
  • id (required) — External identifier of the currency record to update or create.
  • includeInFxRateUpdates — Mark currency for daily exchange-rate updates.
  • currencyPrecision — Number of decimal places (0 or 2) used in currency transactions.
  • exchangeRate — Default exchange rate against the company’s base currency.
  • externalId — External identifier field for the currency.
  • formatSample — Sample display format for currency amounts.
  • fxRateUpdateTimezone.id — Internal identifier for the Fx Rate Update Timezone.
  • fxRateUpdateTimezone.refName — Reference name for the Fx Rate Update Timezone.
  • isInactive — Set the currency record to inactive if true.
  • isBaseCurrency — Mark the currency as the company's base currency.
  • name — Unique name for the currency, often including country.
  • overrideCurrencyFormat — Enable custom formatting for the currency.
  • Prefer — Server behavior; choose 'respond-async' to run request asynchronously.
  • refName — Reference name for the currency record.
  • replace — Comma‑separated list of sublist names to replace.
  • replaceSelectedFields — If true, all fields in the update request must be included in the replace query.
  • displaySymbol — Symbol used for the currency, e.g., "$ USD".
  • symbolPlacement.id — Internal identifier for symbol placement.
  • symbolPlacement.refName — Reference name for symbol placement.
  • X-NetSuite-Idempotency-Key — Unique key for idempotent asynchronous requests.
  • X-NetSuite-PropertyNameValidation — Strictness for property name validation (Error, Warning, Ignore).
  • X-NetSuite-PropertyValueValidation — Strictness for property value validation (Error, Warning, Ignore).
  • customFields — List of custom fields to add or update; each item contains fieldName, fieldType, and value.

Output shape

a single object representing the NetSuite response for the currency record, or, if debug mode is enabled, an object containing both request and response details

No pagination is involved. The response includes the updated or created currency data. If the request fails, an error object is returned.

Examples

Example 1: Create a new currency record for the Euro

id: "EUR", name: "Euro", symbol: "€", currencyPrecision: 2, exchangeRate: 1.0, isBaseCurrency: true, isDebugMode: true

Example 2: Update an existing currency to deactivate it

id: "USD", isInactive: true, replaceSelectedFields: true, isDebugMode: false

Example 3: Add a custom field to an existing currency

id: "JPY", customFields: [{ fieldName: "CustomTaxRate", fieldType: "number", value: 0.05 }], isDebugMode: false

Discussion