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

# Listes

> Regrouper les contacts pour les viser.

Une liste regroupe des contacts de la base : « Clients », « Newsletter », « Salon 2026 ». Un contact peut appartenir à plusieurs listes ; le retirer d’une liste ne le supprime pas de la base.

Les listes servent à cibler les [campagnes](https://docs.dexnotify.com/campagnes/introduction.md), les [envois SMS groupés](https://docs.dexnotify.com/sms/envoi-groupe.md) (`groupIds`) et à déclencher les [automatisations](https://docs.dexnotify.com/campagnes/automatisations.md) à l’entrée d’un contact.

| Route | Effet |
| - | - |
| `POST /api/v1/contact-groups` | crée une liste ; son nom est unique dans le projet |
| `GET /api/v1/contact-groups` | les listes du projet, avec leur nombre de contacts |
| `PATCH /api/v1/contact-groups/{id}` | renomme une liste ou change sa description |
| `DELETE /api/v1/contact-groups/{id}` | supprime une liste ; ses contacts restent dans la base |
| `GET /api/v1/contact-groups/{id}/contacts` | les contacts d’une liste |
| `POST /api/v1/contact-groups/{id}/contacts` | ajoute un contact à la liste |
| `DELETE /api/v1/contact-groups/{id}/contacts/{contactId}` | retire un contact de la liste |
| `POST /api/v1/contact-groups/{id}/contacts/copy` | copie des contacts vers une autre liste |
| `POST /api/v1/contact-groups/{id}/contacts/move` | déplace des contacts vers une autre liste |

```bash theme={null}
curl -X POST https://api.dexnotify.com/api/v1/contact-groups \
  -H "x-api-key: $DEXNOTIFY_CLE" -H "content-type: application/json" \
  -d '{"name":"Newsletter","description":"Inscrits depuis le site"}'
```

Dans l’API, une liste s’appelle `contact-group` ; dans le dashboard, **Audience › Listes**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.