> ## Documentation Index
> Fetch the complete documentation index at: https://developer.z-api.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar nova etiqueta

> Cria uma nova etiqueta para atribuição em chats

## Conceituação

Nesse método você será capaz de criar uma nova etiqueta disponível para atribuição em chats.

***

## Atributos

### Header

<ParamField path="instanceId" type="string" required>
  ID da sua instância. Disponível no painel Z-API em **Instâncias**.
</ParamField>

<ParamField path="token" type="string" required>
  Token da sua instância Z-API.
</ParamField>

### Obrigatórios

<ParamField body="name" type="string" required>
  Nome da etiqueta
</ParamField>

### Opcionais

<ParamField body="color" type="number">
  Índice da cor desejada conforme disponível na API de cores
</ParamField>

***

## Request Body

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{
  "name": "Nome da etiqueta",
  "color": 1
}
```

***

## Response

### 200

<ResponseField name="id" type="string">
  ID da etiqueta criada
</ResponseField>

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{
  "id": "10"
}
```

### 405

Neste caso certifique que esteja enviando corretamente a especificação do método, ou seja verifique se você enviou o POST ou GET conforme especificado no início deste tópico.

### 415

Caso você receba um erro 415, certifique de adicionar na headers da requisição o "Content-Type" do objeto que você está enviando, em sua grande maioria "application/json".