---
title: "Create a branch"
method: POST
path: "/projects/{project_id}/branches"
tags: ["Branches"]
---

# Create a branch

`POST /projects/{project_id}/branches`

Creates a branch in the project. Before using this endpoint, please enable Branching in your project by following [this guide](https://docs.lokalise.com/en/articles/3391861-project-branching).
Requires admin right.

**Project Type Compatibility:**
- ✅ **Software projects** (localization_files) - *Only project type that supports branching*
- ❌ **Documents projects** (paged_documents) - *Branching not supported*
- ❌ **Marketing projects** (content_integration, marketing, marketing_integrations) - *Branching not supported*

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

## Path parameters

- `project_id` string, required

## Request body

- object
  - `name` string — Branch name.

## Response `200`

OK

- object
  - `project_id` string
  - `branch` Branches
    - `branch_id` number — A unique identifier of the branch.
    - `name` string — Branch name.
    - `created_at` string — Date of branch creation.
    - `created_at_timestamp` number — Unix timestamp when branch was created.
    - `created_by` number — An identifier of a user who has created the branch.
    - `created_by_email` string — An e-mail of a user who has created the branch.

---

[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)
