# Crear una etiqueta

> plazbot tags create: agrega una etiqueta al catálogo del workspace.

Fuente: https://developers.plazbot.com/cli/tags/create/

### Crear una etiqueta

Agrega una etiqueta al catálogo del workspace. Antes de crearla comprueba que no exista otra activa con el mismo nombre (sin distinguir mayúsculas). Pide confirmación salvo que pases `--yes`.

```bash
plazbot tags create <name> [options]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Nombre | `<name>` | Sí | Nombre de la etiqueta. Usa comillas si tiene espacios. |
| Color | `--color <hex>` | No | Color en formato `#RRGGBB`. Por defecto `#71717a` (gris). |
| Confirmar | `-y, --yes` | No | No pide confirmación (scripts, CI y agentes de IA). |
| Workspace | `-w, --workspace <id>` | No | Workspace donde crearla. Por defecto, el activo. |
| Zona | `-z, --zone <zone>` | No | `LA` o `EU`. Por defecto, la zona activa. |
| JSON | `--json` | No | Imprime la respuesta de la API en JSON. |

Sin terminal interactiva (scripts, CI, agentes de IA) el comando falla con `confirmation_required` si no pasas `--yes`.

### Ejemplos

```bash
# Crear una etiqueta (pide confirmación)
plazbot tags create VIP --color "#22c55e"

# Desde un script
plazbot tags create "Cliente recurrente" --color "#3b82f6" --yes --json
```

Para etiquetar un contacto usa [`contacts update --add-tag`](https://developers.plazbot.com/cli/contacts/update) con el ID que devuelve [`tags list`](https://developers.plazbot.com/cli/tags/list).

### Resultado

```text
? Create tag "VIP" in workspace Mi Empresa? Yes

Tag "VIP" created
```

### Salida JSON

La respuesta de la API (`{ "success": true, "message": "...", "data": ... }`).

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `A tag named "..." already exists (mot_...).` | Ya hay una etiqueta activa con ese nombre | Usa la existente (el ID sale en el mensaje) |
| `Invalid color "..."` | El color no es `#RRGGBB` | Ejemplo: `--color "#22c55e"` |
| `This action needs confirmation and there is no interactive terminal.` | Sin terminal y sin `--yes` | Agrega `--yes` |
| `This session is read-only: it cannot change data.` | La sesión se creó con `plazbot login --read-only` | Inicia sesión sin `--read-only` |