---
title: "Create/update a branch"
method: PUT
path: "/branches/{branch_id}"
tags: ["Store API endpoints"]
---

# Create/update a branch

`PUT /branches/{branch_id}`

Use this endpoint to create/update a branch.

A branch belongs to a brand, and when a branch is created through this API, it is not considered as a real branch in our system.
However, there is a manual process required by our operations team to map the branch to an actual Careem outlet.
This process must be completed only once after each new branch is created using this API.
You cannot create any catalog for a branch until it has mapped.

## Path parameters

- `branch_id` string, required

## Headers

- `Authorization` string, required
- `User-Agent` string, required
- `Brand-Id` string, required

## Request body

- PutBranchRequest — The body required to create/update a branch
  - `name` string, required

## Response `200`

Branch updated successfully

- Branch — Branch information
  - `id` string, required — The id of the branch
  - `name` string, required — The name of the branch.
  - `brand_id` string, required — the parent brand id of this branch
  - `state` 'UNMAPPED' | 'MAPPED', required — The state of this branch.
  - `created_at` string, required — Time RFC3339 format in UTC in which the brand has been updated
  - `updated_at` string, required — Time RFC3339 format in UTC in which the brand has been updated

## Other responses

- `201` — Branch created successfully
- `400` — Bad request
- `409` — Branch with the specified name already exists
- `500` — Internal server error

---

[API](https://skmtc.net/careemnow/apis/careem-pos-api.md) · [All operations](https://skmtc.net/careemnow/apis/careem-pos-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/careemnow/careem-pos-api/versions/374e3e0dddca/schema)