---
title: "Create Translation"
description: "Use POST /translations (Translation.register) to create a translation."
canonical: https://docs.ordering.co/api-reference/guides/create-translation/
---

# Create Translation

> **API operation:** [Open the endpoint in Scalar](https://docs.ordering.co/api-reference/#tag/translations/POST/translations)

Use `POST /translations` (`Translation.register`) to create a translation. Authentication and the `lang_key`, language, and value fields depend on the current contract. SDK examples may vary by package and version, so check compatibility before using one.

## OpenAPI reference

**Operation:** `POST /translations`

**Request body fields**

| Name            | Type   | Required |
| --------------- | ------ | -------- |
| `key`           | any    | Yes      |
| `language_code` | any    | No       |
| `text`          | any    | Yes      |
| `version`       | string | No       |

**Responses**

| Code | Description                           |
| ---- | ------------------------------------- |
| 200  | OK (Envelope)                         |
| 400  | Bad Request (ErrorResponse)           |
| 401  | Unauthorized                          |
| 404  | Not Found                             |
| 429  | Too Many Requests (ErrorResponse)     |
| 500  | Internal Server Error (ErrorResponse) |
| 503  | Service Unavailable (ErrorResponse)   |

[Open this operation in the API reference](https://docs.ordering.co/api-reference/#tag/translations/POST/translations)