> For the complete documentation index, see [llms.txt](https://docs.qentaz.com/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qentaz.com/documentation/cuentas-administradas/crear-una-sucursal.md).

# Crear una sucursal

Crea una cuenta administrada para una sucursal o unidad operativa.

La sucursal hereda la configuración, información legal y operación de la cuenta padre. No requiere compliance porque pertenece a la misma entidad jurídica.

## Ruta

<mark style="color:green;">`POST`</mark> `/v1/business/branch`

## **Encabezados**

| Name                                                   | Value               |
| ------------------------------------------------------ | ------------------- |
| `Content-Type`*<mark style="color:red;">**\***</mark>* | `application/json`  |
| `x-auth-token`*<mark style="color:red;">**\***</mark>* | `YOUR_SECRET_TOKEN` |

## **Cuerpo de la petición**

<table><thead><tr><th width="249">Name</th><th width="113">Type<select><option value="rRB3kMFO5APd" label="string" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:violet;"><code>branch_id</code></mark><em><mark style="color:red;"><strong>*</strong></mark></em></td><td><span data-option="rRB3kMFO5APd">string</span></td><td>Identificador único de la sucursal para este negocio.</td></tr><tr><td><mark style="color:violet;"><code>branch_name</code></mark><em><mark style="color:red;"><strong>*</strong></mark></em></td><td><span data-option="rRB3kMFO5APd">string</span></td><td>Nombre de la sucursal.</td></tr></tbody></table>

## **Respuesta**

{% tabs %}
{% tab title="200" %}

```json
{
  "message": "Sucursal creada exitosamente",
  "branch_id": "north-zone",
  "branch_name": "Zona Norte",
  "child_type": "BRANCH",
  "managing_business_id": "PAY-001",
  "created_at": "2023-10-15T08:00:00-05:00"
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "internalCode": "Q304",
  "message": "Uno o más campos no se encuentran diligenciados correctamente o no son correctos. Por favor revisa los campos [campo_invalido]"
}
```

{% endtab %}

{% tab title="404" %}

```json
{
  "internalCode": "Q304",
  "message": "No se encontró información para la consulta realizada. Verifica los parámetros de búsqueda e inténtalo nuevamente."
}
```

{% endtab %}
{% endtabs %}

***

## Ejemplo

{% tabs %}
{% tab title="cURL" %}

```bash
curl --location '{{base_url}}/v1/business/branch' \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'x-auth-token: YOUR_SECRET_TOKEN' \
  --data '{
  "branch_id": "north-zone",
  "branch_name": "Zona Norte"
}'
```

{% endtab %}
{% endtabs %}