# Create a branch

Creates a new branch. {% admonition type="info" name="Note"%}Branch names must be unique. A maximum of five branches per tenant is supported.{% /admonition %}

Endpoint: POST /api/v2/cm/branches
Version: v2.0
Security: OAuth2.0

## Request fields (application/json-patch+json):

  - `id` (string, required)

  - `name` (string, required)

  - `source` (string, required)

## Response 201 fields (application/json):

  - `system` (object, required)

  - `system.createdAt` (string, required)

  - `system.createdBy` (string,null, required)

  - `system.hash` (string,null, required)

  - `system.type` (string,null, required)

  - `system.updatedAt` (string,null)

  - `system.updatedBy` (string,null)

  - `id` (string,null)

  - `source` (string,null)

  - `name` (string,null)

  - `path` (string,null)

## Response 400 fields (application/json):

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)


## Response 500 fields