# Insertar Etiqueta

Para crear una nueva etiqueta, se debe realizar la siguiente consulta.

<mark style="color:green;">`POST`</mark> `https://api.persat.com.ar/v1/deliveries-labels`

#### Headers

| Name                                            | Type   | Description      |
| ----------------------------------------------- | ------ | ---------------- |
| Authorization<mark style="color:red;">\*</mark> | String | Bearer API\_KEY  |
| Content-Type<mark style="color:red;">\*</mark>  | String | application/json |

#### Request Body

| Name                                    | Type   | Description                                                                                                                                                                          |
| --------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| name<mark style="color:red;">\*</mark>  | String | Nombre de la etiqueta. Max. 20 caracteres                                                                                                                                            |
| color<mark style="color:red;">\*</mark> | String | Color de la etiqueta. Los colores habilitados se pueden ver en [Obtener Etiqueta](https://docs.api.persat.com.ar/modulos/gestion-de-entregas/administrar-etiquetas/obtener-etiqueta) |

{% tabs %}
{% tab title="200: OK La consulta se ejecutó con éxito" %}

```json
{
    "success": true,
    "data": {
        "id": 21,
        "name": "Etiqueta nueva",
        "color": "BLACK_3"
    }
}
```

{% endtab %}

{% tab title="400: Bad Request Error en la consulta" %}

```json
{
    "success": false,
    "error": {
        "status": 400,
        "type": "BAD_REQUEST",
        "userMessage": "'color' debe ser un string. Ver colores habilitados en la documentacion"
    }
}
```

{% endtab %}
{% endtabs %}

### Análisis de la Respuesta

```json
{
    "success": true,
    "data": {
        "id": 21,
        "name": "Etiqueta nueva",
        "color": "BLACK_3"
    }
}
```

Los datos obtenidos son los datos de la etiqueta creada tal como se puede ver en [Obtener Etiqueta](https://docs.api.persat.com.ar/modulos/gestion-de-entregas/administrar-etiquetas/obtener-etiqueta)