# Creer un tag

> Transmettez un nom d'affichage — la cle du tag (son identifiant dans le reste de l'API) est generee automatiquement en slugifiant le nom (minuscules…

`POST /v2/api/tags`

<Note>
**Scope requis :** `TAGS_WRITE`
</Note>

## Comportement

Transmettez un **nom** d'affichage — la **cle** du tag (son identifiant dans le reste de l'API) est generee automatiquement en slugifiant le nom (minuscules, alphanumerique). Par exemple `"Interested"` devient la cle `interested`.

- Les noms sont insensibles a la casse. Creer `Support` alors que `support` existe deja retourne une erreur `409` avec le code `TAG_ALREADY_EXISTS`.
- Les noms qui decrivent un resultat d'appel (ex. `voicemail`, `missed call`, `busy`) sont reserves et rejetes avec une erreur `400` et le code `TAG_NAME_IS_CALL_OUTCOME`.
- `color` est une chaine hexadecimale optionnelle (7 caracteres maximum, ex. `#FF0000`).

L'`id` du tag cree est la cle generee — utilisez-la pour ajouter le tag a des appels ou pour le supprimer.

## Idempotence

Cet endpoint prend en charge l'en-tete `Idempotency-Key`. Si une requete reussit et que vous la renvoyez avec la meme cle, la reponse stockee est retournee sans re-executer l'operation. Voir [Idempotence](/fr/docs/guides/error-handling#idempotency).
