---
title: "Create a project"
method: POST
path: "/projects"
tags: ["Projects"]
---

# Create a project

`POST /projects`

Creates a new project in the specified team. Requires *Admin* role in the team.

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

## Request body

- object
  - `name` string, required — Name of the project.
  - `team_id` number — ID of the team to create a project in. If this parameter is omitted, the project will be created in current team of the user, whose API token is specified.
  - `description` string — Description of the project.
  - `languages` object[] — List of languages to add.
    - `lang_iso` string, required — A unique language code in the system.
    - `custom_iso` string — Override language/locale code.
  - `base_lang_iso` string — Language/locale code of the project base language. Should be in a scope of <code>languages</code> list. Use <code>custom_iso</code> code in case it was defined.
  - `project_type` 'localization_files' | 'paged_documents' | 'content_integration' — Project type. **Note: Only <code>localization_files</code> projects support branching.** Available types:\n- <code>localization_files</code> - **Software projects** (Web and mobile) - Supports branching, individual key management, JWT/OTA tokens\n- <code>paged_documents</code> - **Documents projects** (Ad hoc documents) - ⚠️ *Branching not supported*\n- <code>content_integration</code> - **Marketing projects** (Marketing and support) - ⚠️ *Branching not supported*
  - `is_segmentation_enabled` boolean — Enable Segmentation feature for project.

## Response `200`

OK

- Projects
  - `project_id` string — A unique project identifier.
  - `project_type` string — Project type descriptor. Allowed values are <code>localization_files</code> or <code>paged_documents</code>.
  - `name` string — Project name.
  - `description` string — Description of the project.
  - `created_at` string — Date of project creation.
  - `created_at_timestamp` number — Unix timestamp when project was created.
  - `created_by` number — An identifier of a user who has created the project.
  - `created_by_email` string — An e-mail of a user who has created the project.
  - `team_id` number — A unique identifier of the team, the project belongs to.
  - `base_language_id` number — A unique identifier of the project default language.
  - `base_language_iso` string — A language/locale code of the project default language.
  - `settings` object — An object containing project settings.
    - `per_platform_key_names` boolean — If enabled project has different key names for different platforms.
    - `reviewing` boolean — If enabled contributors has reviewer access for project.
    - `auto_toggle_unverified` boolean — If enabled Lokalise will automatically mark translations Unverified in case translation of base language was changed.
    - `offline_translation` boolean — If enabled translators are able to download and upload translations as XLIFF files from the Editor.
    - `key_editing` boolean — If enabled keys are allowed to be modified.
    - `inline_machine_translations` boolean — If enabled inline machine translations are enabled to all project users.
    - `branching` boolean — If enabled then branching will be available.
    - `segmentation` boolean — If enabled then segmentation will be available.
    - `custom_translation_statuses` boolean — If enabled then custom translation statuses will be available.
    - `custom_translation_statuses_allow_multiple` boolean — If enabled then multiple custom translation statuses will be allowed.
    - `contributor_preview_download_enabled` boolean — If enabled then translators will be allowed to preview content by downloading target files from the Editor
  - `statistics` object — An object containing project statistics, QA issues and project languages progress.
    - `progress_total` number — Overall percent of project progress.
    - `keys_total` number — Count of keys in the project.
    - `team` number — Team members count in the project.
    - `base_words` number — Count of words in a base language of the project.
    - `qa_issues_total` number — Overall count of QA issues in the project.
    - `qa_issues` object — An object containing count for each QA issue type.
      - `not_reviewed` number — Count of not reviewed translations.
      - `unverified` number — Count of unverified translations.
      - `spelling_grammar` number — Count of translations with spelling and/or grammar errors.
      - `inconsistent_placeholders` number — Count of translations with inconsistent placeholders (source vs target).
      - `inconsistent_html` number — Count of translations with inconsistent HTML tags (source vs target).
      - `different_number_of_urls` number — Count of translations with different number of URLs (source vs target).
      - `different_urls` number — Count of translations with different URLs (source vs target).
      - `leading_whitespace` number — Count of translations with leading whitespace.
      - `trailing_whitespace` number — Count of translations with trailing whitespace.
      - `different_number_of_email_address` number — Count of translations with different number of email address (source vs target).
      - `different_email_address` number — Count of translations with different email address (source vs target).
      - `different_brackets` number — Count of translations with different brackets (source vs target).
      - `different_numbers` number — Count of translations with different numbers (source vs target).
      - `double_space` number — Count of translations with double spaces (target).
      - `special_placeholder` number — Count of invalid use of [VOID], [TRUE], [FALSE] placeholders (target).
      - `unbalanced_brackets` number — Count of unbalanced brackets (target).
    - `languages` object[] — An array of project languages with progress percent.
      - `language_id` number — A unique language identifier in the system.
      - `language_iso` string — Language/locale code.
      - `progress` number — Translated keys percent.
      - `words_to_do` number — Count of words remaining to translate from projects base 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)