> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start — Tags

> Crie uma etiqueta, aplique em contatos e use em segmentos — painel ou API.

<Tip>
  **Tag** é etiqueta reutilizável (`Lead`, `VIP`). Crie uma vez, use em vários contatos e em regras de segmento.
</Tip>

## Em poucas palavras

* **Crie** a tag no painel ou com `POST /v1/tags`.
* **Aplique** na ficha do contato com `tagIds` ou na importação.
* **Filtre** em segmentos com regra `type: tag`.

Contexto: [Tags na audiência](/contacts-api/como-funciona/tags-na-audiencia). Escopos: [Escopos de tags](/contacts-api/como-funciona/tags-escopos-da-api-key).

## Antes de começar

| Item                         | Obrigatório                         |
| ---------------------------- | ----------------------------------- |
| Escopo **`tags:create`**     | Para criar                          |
| Escopo **`tags:read`**       | Para listar                         |
| Escopo **`contacts:update`** | Para colar tag em contato existente |

Auth: `Authorization: Bearer sk_live_...` ou `x-api-key`. Base URL: `https://api.notifique.dev`.

***

## 1. Pelo painel

1. **Audiência → Tags → Nova**
2. Nome curto (`Lead`, `Cliente`, `Black Friday`)
3. Na ficha do contato ou na importação, marque as tags desejadas

***

## 2. Criar tag (API)

```http theme={null}
POST /v1/tags
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx
```

```json theme={null}
{
  "name": "VIP"
}
```

Resposta **200** — guarde o `id` para usar em contatos e segmentos.

***

## 3. Listar tags

```http theme={null}
GET /v1/tags?page=1&limit=50
Authorization: Bearer sk_live_xxxxx
```

***

## 4. Aplicar tag em um contato

Ao **criar** ou **editar** o contato, envie `tagIds`:

```http theme={null}
PUT /v1/contacts/{id}
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx
```

```json theme={null}
{
  "tagIds": ["clxxTagVip", "clxxTagLead"]
}
```

***

## 5. Usar em segmento

```json theme={null}
{
  "version": 1,
  "match": "all",
  "rules": [
    { "type": "tag", "tagId": "clxxTagVip" },
    { "type": "receiveMarketing", "value": true }
  ]
}
```

Detalhes: [Segmentos — Quick Start](/contacts-api/como-funciona/segmentos-quick-start).

***

## Próximos passos

* [Segmentos na audiência](/contacts-api/como-funciona/segmentos-na-audiencia)
* [Campanhas](/contacts-api/como-funciona/campanhas-no-painel)
* [Introdução](/contacts-api/como-funciona/introducao)