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

# Importer

> Un fichier CSV ou XLSX dans la base.

Un import lit un fichier, crée les nouveaux contacts, met à jour ceux qui existent déjà (par e-mail ou par numéro) et les ajoute à une liste si vous le demandez.

```bash theme={null}
curl -X POST https://api.dexnotify.com/api/v1/contacts/imports \
  -H "x-api-key: $DEXNOTIFY_CLE" \
  -F file=@clients.xlsx \
  -F 'mapping={
    "phone": "Téléphone",
    "name": "Nom",
    "fields": { "email": "E-mail", "firstName": "Prénom", "lastName": "Nom de famille" },
    "attributes": { "ville": "Ville" },
    "hasHeader": true,
    "defaultCountry": "SN",
    "updateExisting": true
  }'
```

| Clé de `mapping` | Description |
| - | - |
| `phone`, `fields.email` | Les colonnes du numéro et de l’e-mail ; il en faut au moins une. |
| `name`, `fields.firstName`, `fields.lastName` | Les colonnes du nom. |
| `attributes` | `{ "nomDeLAttribut": "Colonne" }` pour vos champs libres. |
| `hasHeader` | La première ligne porte les en-têtes. Sans en-tête, désignez les colonnes par leur rang, à partir de 1. |
| `defaultCountry` | Le pays des numéros écrits sans indicatif (`SN` par défaut). |
| `updateExisting` | Met à jour la fiche d’un contact déjà connu, au lieu de l’ignorer. |

Pour importer directement dans une liste : `POST /api/v1/contact-groups/{id}/imports`, même corps.

## Suivre l’import

L’import tourne en arrière-plan.

| Route | Rend |
| - | - |
| `GET /api/v1/contacts/imports/{id}` | la progression : lignes lues, importées, en doublon, refusées |
| `GET /api/v1/contacts/imports/{id}/errors` | un CSV des lignes refusées : ligne, valeur, code, motif |
| `POST /api/v1/contacts/imports/{id}/cancel` | arrête l’import ; les contacts déjà importés restent |

> [!TIP]
>
> Le dashboard propose le même import avec un aperçu des colonnes et une correspondance assistée : **Audience › Contacts › Importer**.


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