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

# Scopes — Tags

> API Key permissions to create and manage tags (`tags:*`).

<Tip>
  Tags use only the **`tags:*`** family. Applying a tag on a contact record also requires **`contacts:update`**.
</Tip>

## Scopes

| Scope             | Allows                              |
| ----------------- | ----------------------------------- |
| **`tags:read`**   | `GET /v1/tags`, `GET /v1/tags/{id}` |
| **`tags:create`** | `POST /v1/tags`                     |
| **`tags:update`** | `PUT /v1/tags/{id}`                 |
| **`tags:delete`** | `DELETE /v1/tags/{id}`              |

Associating a tag with a contact: `tagIds` in `POST/PUT /v1/contacts` — scopes **`contacts:create`** / **`contacts:update`**.

## Common combinations

| Flow                      | Scopes                                                         |
| ------------------------- | -------------------------------------------------------------- |
| List tags only            | `tags:read`                                                    |
| CRM syncs tags + contacts | `tags:read`, `tags:create`, `contacts:read`, `contacts:update` |
| Full tag management       | `tags:read`, `tags:create`, `tags:update`, `tags:delete`       |

## Common errors

| Code    | Cause                                    |
| ------- | ---------------------------------------- |
| **403** | Key missing `tags:read` or `tags:create` |
| **409** | Duplicate tag name in the workspace      |

General key guide: [API Key scopes](/en/contacts-api/como-funciona/escopos-da-api-key).

## Next steps

* [Quick Start — Tags](/en/contacts-api/como-funciona/tags-quick-start)
* [Tags in the Audience](/en/contacts-api/como-funciona/tags-na-audiencia)