---
title: "POST /v1/translations"
method: POST
path: "/v1/translations"
tags: ["Localization"]
---

# POST /v1/translations

`POST /v1/translations`

Sets translation content for translatable fields. 
 
 Use this API to add new translations or update existing ones as needed. 
 
 The request payload has a maximum size of 100 KB.

## Headers

- `x-publisher-token` string, required

## Request body

- TranslationRequest
  - `dynamicTranslations` DynamicTranslation[], required — A list of translations for dynamic entities you define such as offer and product names.
    - `type` string — Entity type. Values include: 'offer', 'offer_design', 'product', 'section', 'builder', 'ribbon'
    - `externalId` string — The ID as defined in the Publisher Dashboard.
    - `field` string — The entity field the translation applies to. Values include: 'display_name', 'description', 'title', 'text', 'prefix', 'suffix'
    - `locale` string — The locale code. Both ISO-639 language code and ISO-3166 country code formats are supported.
    - `value` string — The translation text for the specified field and locale.
  - `staticTranslations` StaticTranslation[], required — A list of translations for static UI elements such as button labels and headers.
    - `key` string — The key identifier for the static translation.
    - `locale` string — The locale code. Both ISO-639 language code and ISO-3166 country code formats are supported.
    - `value` string — The translation value associated with the key and locale.

## Response `200`

Translations retrieved successfully.

- TranslationResponse
  - `dynamicTranslations` DynamicTranslation[] — A list of translations for dynamic entities you define such as offer and product names.
    - `type` string — Entity type. Values include: 'offer', 'offer_design', 'product', 'section', 'builder', 'ribbon'
    - `externalId` string — The ID as defined in the Publisher Dashboard.
    - `field` string — The entity field the translation applies to. Values include: 'display_name', 'description', 'title', 'text', 'prefix', 'suffix'
    - `locale` string — The locale code. Both ISO-639 language code and ISO-3166 country code formats are supported.
    - `value` string — The translation text for the specified field and locale.
  - `staticTranslations` StaticTranslation[] — A list of translations for static UI elements such as button labels and headers.
    - `key` string — The key identifier for the static translation.
    - `locale` string — The locale code. Both ISO-639 language code and ISO-3166 country code formats are supported.
    - `value` string — The translation value associated with the key and locale.

## Other responses

- `400` — Invalid request payload.
- `401` — Missing or invalid authentication.
- `403` — Insufficient permissions.

---

[API](https://skmtc.net/appcharge/apis/grant-award.md) · [All operations](https://skmtc.net/appcharge/apis/grant-award/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/appcharge/grant-award/revisions/b4f6759240d5/schema)