API de courriels (clé mk_…)
Piloter abonnés, étiquettes, campagnes et automatisations depuis un autre outil.
À quoi ça sert
Automatiser les courriels depuis une application externe.
Prérequis et forfait
Notions de développement.
Étapes
- Ouvrez « Courriels », section « Intégration par API ».
- Saisissez un « Nom de la clé » et cliquez sur « Créer une clé d’API ». Copiez la clé
mk_…tout de suite : elle n’est affichée qu’une fois. - Appelez
mail-api.php?r=subscribersavec l’en-têteAuthorization: Bearer mk_…. - Ressources :
subscribers,subscriber,tags,tag,campaigns,campaign,campaign_launch,campaign_pause,campaign_resume,automations,automation. - Pour retirer l’accès, cliquez sur « Révoquer ».
Résultat attendu
Les réponses sont en JSON. Les quotas du forfait s’appliquent (réponse 402) ; au plus 300 requêtes par tranche de 15 minutes et par clé (429 au-delà).
Astuces
consent: truedans le corps d’un abonné enregistre son consentement : ne l’envoyez que s’il est réel.- Une campagne lancée par l’API suit les mêmes règles (adresse, consentement).
Problèmes fréquents
401 « Clé d’API manquante ou invalide. »
En-tête absent, clé incomplète ou révoquée.
403 « Les courriels ne sont pas inclus dans ce forfait. »
Compte désactivé.
402 quota_exceeded
Limite du forfait atteinte (abonnés, campagnes ou automatisations).
429 « Trop de requêtes. »
Plus de 300 requêtes en 15 minutes avec la même clé.