> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Upload custom translation files

> Before uploading your translation files using the /translations endpoint, ensure that they are linguistically accurate and representative of the user experience.

POST/translations

> [!CAUTION]
>
> **Important**
>
> Before uploading your translation files using the /translations endpoint, ensure that they are linguistically accurate and representative of the user experience.

Use this endpoint to upload custom translation files for a specific program. This endpoint allows you to customize the values for the keys contained in the `translations` object so that they will appear in the target language in the customer-facing UI. UX Toolkit uses key and value pairs to render the translations used in web components. Each key is an identifier used to reference a specific piece of content in a web component, while the value is the translated text string that replaces that key on the customer-facing UI. See the sample request body that follows for an example.

For a full list of keys, contact your Marqeta onboarding specialist.

See also the [Using custom translation files](https://www.marqeta.com/docs/developer-guides/uxt-getting-started.md#_using_custom_translation_files) section in the [UX Toolkit Getting Started](https://www.marqeta.com/docs/developer-guides/uxt-getting-started.md) guide.

## Request body

| Fields | Description |
| - | - |
| program\_short\_code string  Required | Program short code on the Marqeta platform. **Allowable Values:**  Existing program short code |
| language\_code string  Required | Language code associated to translations. **Allowable Values:**  `bg-BG`, `ca-ES`, `cs-CZ`, `de-DE`, `el-GR`, `en-GB`, `en-US`, `es-ES`, `et-EE`, `fi-FI`, `fr-CA`, `fr-FR`, `hr-HR`, `hu-HU`, `it-IT`, `lt-LT`, `lv-LV`, `nl-NL`, `pl-PL`, `pt-BR`, `pt-PT`, `ro-RO`, `ru-RU`, `sk-SK`, `sl-SI`, `sv-SE` |
| translations object  Required | Object that contains a list of key/value pairs for translations. For a full list of keys, contact your Marqeta onboarding specialist. **Allowable Values:**  Valid JSON object |

## Sample request body

```json JSON lines wrap theme={null}
{
  "program_short_code": "mqtest",
  "language_code": "es-ES",
  "translations": {
      "translation": {
          "activate_card": "Activar tu tarjeta",
          "replace_card": "Reemplazar tu tarjeta"
      }
  }
}
```

## Sample response body

The only response for a call made to the `/translations` endpoint is `201 Successfully uploaded a translation`.

```json JSON lines wrap theme={null}
HTTP response code 201
```

For the full list of codes supported by the Marqeta platform, see [HTTP response codes](https://www.marqeta.com/docs/core-api/errors.md#http-response-codes)


## Related topics

- [Customizing UX Toolkit](https://www.marqeta.com/docs/developer-guides/uxt-customizing-ux-toolkit.md)
- [About UX Toolkit](https://www.marqeta.com/docs/developer-guides/about-ux-toolkit.md)
- [UX Toolkit Overview](https://www.marqeta.com/docs/core-api/uxt-sdk.md)
- [Upload card art](https://www.marqeta.com/docs/core-api/uxt-sdk/upload-card-art.md)
- [2025](https://www.marqeta.com/docs/developer-guides/ux-toolkit-release-notes/2025.md)