# Importer des listes depuis Ghost, beehiiv ou Kit

Le parcours public à documenter ici est un import de contacts et de listes. Il ne promet pas la reprise des publications ni des abonnements payants.

## Prérequis

- Une clé d’accès en lecture à la source.
- L’accès à VaEmail et la portée d’import de contacts.
- Une liste cible et un export ou une connexion source validée.
- Un essai à blanc avant toute écriture.

## Tutoriel

Pour l’import générique, utilise `POST /v3/contacts/import` ou l’outil MCP `vaemail_importer_contacts`. Le MCP accepte jusqu’à 500 contacts par appel et ne réabonne jamais une adresse désinscrite. Conserve la source dans les attributs de contact et contrôle les doublons avant de poursuivre.

La migration VaEmail sait lire Ghost et beehiiv. Elle lit les membres ou abonnés pour construire des contacts et des listes. Kit n’a pas de migration dédiée : importe son export de contacts avec la route générique.

## Comment tester

Commence par une petite liste et utilise le mode `a_blanc` du parcours de migration quand il est proposé. Vérifie le rapport : contacts importés, contacts déjà présents, listes, exclusions et contacts en attente. Pour le parcours API générique, relis la liste et un contact après l’import.

## Limites

Ce guide ne reprend pas les publications, les modèles, les formulaires, les scénarios, les segments ni l’historique des campagnes. Les abonnements payants, paiements et comptes Stripe ne sont pas migrés : pour Ghost et beehiiv, le niveau payant peut seulement devenir une information de liste. Kit n’a pas de connecteur source dédié dans le dépôt.

## Reprise après erreur

Ne relance pas un lot entier sans lire le rapport. Reprends les seules adresses invalides ou absentes, garde la même référence externe quand elle existe et ne réabonne pas les désinscrits. Une erreur de clé ou de source se corrige côté source avant un nouvel essai à blanc.