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

# Create languages

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

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.net/lokalise/apis/default-projects.md) · [All operations](https://skmtc.net/lokalise/apis/default-projects/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lokalise/default-projects/revisions/7bceba421b12/schema)