---
title: "Create languages"
method: POST
path: "/projects/{project_id}:{branch}/languages"
tags: ["Languages"]
---

# Create languages

`POST /projects/{project_id}:{branch}/languages`

## Request

- Base URL: `https://api.lokalise.com/api2`
- URL: `https://api.lokalise.com/api2/projects/{project_id}:{branch}/languages`
- Auth: API key in header `X-Api-Token`

Creates one or more languages in the project. Requires *Manage languages* admin right.

The `language_iso` is the identifer of one of the system languages. You are only required to include the `language_iso` attribute, however you may override the default language code, language name and plural forms as well.

Requires <code>write_languages</code> OAuth access scope.

## Path parameters

- `project_id` string, required
- `branch` string, required

## Request body

- object
  - `languages` object[]: A set of languages to add
    - `lang_iso` string, required: A unique language code in the system.
    - `custom_iso` string: Override language/locale code.
    - `custom_name` string: Override language name.
    - `custom_plural_forms` string[]: Override list of supported plural forms for this language.

## Response `200`

OK

- object
  - `project_id` string
  - `languages` Languages[]
    - `lang_id` number: A unique language identifier in the system.
    - `lang_iso` string: Language/locale code.
    - `lang_name` string: Language name.
    - `is_rtl` boolean: Whether the language is Right-To-Left.
    - `plural_forms` unknown[]: List of supported plural forms.
      - unknown
    - `cc_iso` string: Country code, associated with the language.

---

[API](https://skmtc.dev/lokalise/apis/projects-with-branches.md) - [All operations](https://skmtc.dev/lokalise/apis/projects-with-branches/llms.txt) - [OpenAPI document](https://skmtc.dev/lokalise/apis/projects-with-branches/revisions/7ed3f978a361?raw)