> ## 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

> Create a tag, apply it to contacts, and use it in segments — dashboard or API.

<Tip>
  A **tag** is a reusable label (`Lead`, `VIP`). Create it once, use it on multiple contacts and in segment rules.
</Tip>

## In brief

* **Create** the tag in the dashboard or with `POST /v1/tags`.
* **Apply** it on the contact record with `tagIds` or during import.
* **Filter** in segments with a `type: tag` rule.

Context: [Tags in the Audience](/en/contacts-api/como-funciona/tags-na-audiencia). Scopes: [Tag scopes](/en/contacts-api/como-funciona/tags-escopos-da-api-key).

## Before you start

| Item                        | Required                               |
| --------------------------- | -------------------------------------- |
| Scope **`tags:create`**     | To create                              |
| Scope **`tags:read`**       | To list                                |
| Scope **`contacts:update`** | To attach a tag to an existing contact |

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

***

## 1. In the dashboard

1. **Audience → Tags → New**
2. Short name (`Lead`, `Customer`, `Black Friday`)
3. On the contact record or during import, select the desired tags

***

## 2. Create a tag (API)

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

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

Expected response: **200** — save the `id` to use on contacts and segments.

***

## 3. List tags

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

***

## 4. Apply a tag to a contact

When **creating** or **editing** a contact, send `tagIds`:

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

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

***

## 5. Use in a segment

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

Details: [Segments — Quick Start](/en/contacts-api/como-funciona/segmentos-quick-start).

***

## Next steps

* [Segments in the Audience](/en/contacts-api/como-funciona/segmentos-na-audiencia)
* [Campaigns](/en/contacts-api/como-funciona/campanhas-no-painel)
* [Introduction](/en/contacts-api/como-funciona/introducao)