Importer et exporter ta liste d'abonnés#
Pourquoi#
Tu peux à tout moment exporter ta liste complète et l'importer ailleurs. C'est la traduction concrète de l'engagement anti-lock-in : ta liste t'appartient, on ne la retient pas.
Exporter#
Page de gestion des abonnés du feed → boutons Exporter CSV ou Exporter JSON. Téléchargement immédiat. Seuls les abonnés actifs sont inclus — c'est le format portable, prêt à réimporter ailleurs.
Format CSV :
email,subscribed_at,source
alice@example.com,2024-03-15T10:23:00.000Z,signup
bob@example.com,2024-04-02T14:11:00.000Z,importLe source distingue les inscriptions organiques (signup) des imports en
masse (import).
Importer depuis Substack / Mailchimp / Buttondown#
La plupart des outils exportent en CSV avec une colonne email. Roucoule
accepte ce CSV : la colonne email est lue, le reste est ignoré (sauf
subscribed_at qui est utilisée si présente).
Note Mailchimp. L'export Mailchimp utilise le header
Email Address(avec espace, majuscule). Renomme-le en
- Exporte ta liste depuis ton ancien outil (cherche « Export subscribers », « Download list », etc.).
- Page de gestion des abonnés Roucoule du feed → ouvre le panneau Importer des abonnés.
- Sélectionne le fichier, coche l'attestation de consentement (RGPD : ces personnes ont consenti à recevoir des emails de ta part — tu en es responsable).
- Roucoule te renvoie un récap : combien importés, combien réactivés (anciens désabonnés réabonnés), combien de doublons, combien d'emails invalides (avec leurs lignes).
Format JSON (script / CI)#
Si tu préfères scripter :
curl -X POST https://roucoule.dev/api/v1/feeds/feed_xxx/subscribers/import \
-H "Authorization: Bearer rcl_…" \
-H "Content-Type: application/json" \
-H "X-Roucoule-Consent-Attested: true" \
-d '[
{ "email": "alice@example.com" },
{ "email": "bob@example.com", "subscribedAt": "2024-01-15T00:00:00Z" }
]'Le header X-Roucoule-Consent-Attested: true est obligatoire — il atteste le
consentement, tu en gardes la responsabilité.
Limites#
- 10 000 lignes maximum par requête. Pour des listes plus grosses, scinder en plusieurs imports.
- Pas de mise à jour : un email déjà actif est ignoré (skip), pas écrasé. Si tu veux purger et réimporter, supprime d'abord les abonnés concernés.
- Réactivation : un email présent mais désinscrit est réactivé par l'import
(statut
active, sourceimport).
Voir aussi#
docs/api.md— référence complète des endpoints.