> For the complete documentation index, see [llms.txt](https://docs.cange.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cange.me/api/fluxos/etiquetas/criar-uma-etiqueta.md).

# Criar uma etiqueta

As etiquetas são elementos fundamentais para categorizar e destacar cartões dentro dos fluxos de trabalho no Cange, facilitando a visualização, filtragem e priorização das tarefas em execução. Cada fluxo possui seu próprio conjunto de etiquetas, garantindo organização e contexto específico para cada processo.

Utilizar a API do Cange para criar etiquetas permite automatizar a criação desses marcadores diretamente a partir dos seus sistemas, promovendo consistência e escalabilidade na gestão dos processos.

Para criar uma etiqueta através da API, você precisará ter um token de acesso válido. Se ainda não possui o seu token, consulte nosso guia abaixo sobre como obter o token de autenticação.

{% content-ref url="/pages/9WZ3PW4K1WSS8OpsOrjm" %}
[Autenticação](/api/autenticacao.md)
{% endcontent-ref %}

## Realizando a chamada para criação de uma etiqueta

```http
https://api.cange.me/flow-tag
```

<mark style="color:green;">`POST`</mark> `/flow-tag`&#x20;

**Headers**

| Name          | Value                      |
| ------------- | -------------------------- |
| Content-Type  | `application/json`         |
| Origin        | `https://app.cange.me`     |
| Authorization | `Bearer <token de acesso>` |

**Body**

| Name          | Type   | Description                                 |
| ------------- | ------ | ------------------------------------------- |
| `flow_id`     | number | Código identificador do fluxo               |
| `description` | string | Título da etiqueta                          |
| `color`       | string | Cor da etiqueta (Hexadecimal) Ex: "#4680B8" |

```
{
    "flow_id": 9000,
    "description": "Etiqueta teste",
    "color": "#4680B8"
}
```

**Response**

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

```json
{
    "flow_id": 9000,
    "description": "Etiqueta teste",
    "color": "#4680B8",
    "id_flow_tag": 15544
}
```

{% endtab %}
{% endtabs %}