API, webhooks et MCP

L'API est sur https://api.smartletter.ai. Elle couvre les newsletters, contacts, champs, filtres, topics, séquences, modèles, emails transactionnels, domaines, webhooks et stats. Toutes les routes et les exemples sont dans la référence de l'API.

Elle parle le même langage que Resend. Tu viens de Resend ? Garde ton code et change deux variables :

RESEND_BASE_URL=https://api.smartletter.ai
RESEND_API_KEY=ta_cle

Chaque requête doit avoir un en-tête User-Agent.

Crée tes clés dans Clés API. Seuls les propriétaires et les admins le peuvent. Copie la clé tout de suite : elle n'est affichée qu'une fois.

• Accès complet : tout. Garde-la sur tes serveurs.
• Envoi uniquement : seulement POST /emails (email transactionnel). Elle peut être limitée à un domaine.
• Inscriptions seulement : ajoute seulement des abonnés qui doivent confirmer par email. Sans risque dans le code d'un site.

Tu peux avoir 20 clés actives. Révoquer coupe une clé tout de suite.

Limites : 300 requêtes par minute par clé, et 10 par seconde par espace de travail par défaut. Les réponses portent des en-têtes ratelimit-*.

POST /signups ajoute un abonné depuis ton site. Ça marche avec une clé Inscriptions seulement.

POST https://api.smartletter.ai/signups
Authorization: Bearer <clé inscriptions>
Content-Type: application/json

{ "email": "lecteur@exemple.fr" }

La réponse est toujours 202 avec status: "pending". Le contact confirme d'abord par email. Une même IP peut faire 5 inscriptions par tranche de 10 minutes.

Un webhook prévient ton serveur quand quelque chose se passe. Règle-les dans Webhooks. Starter inclut 3 adresses, Pro 10.

• Emails : envoyé, livré, retardé, rejeté, plainte, ouvert, cliqué, échoué, programmé.
• Contacts : créé, modifié, supprimé. Domaines : créé, modifié, supprimé.
• Séquences : entrée, terminée, sortie. Boîte de réception : message reçu.

Ton adresse doit être en HTTPS et répondre en 2xx sous 10 secondes. Un secret signe chaque événement, au format Resend. Inclure les newsletters envoie un événement par destinataire : ça monte vite.

Utilise Tester, Journal et Changer le secret pour le vérifier et le gérer. Après un changement, l'ancien secret marche encore 24 heures.

Pour les outils qui ne parlent que SMTP, comme WordPress ou Supabase Auth. Crée un identifiant dans SMTP.

Serveur :      smtp.smartletter.ai
Port :         587 (STARTTLS) ou 465 (TLS)
Utilisateur :  smartletter
Mot de passe : ton identifiant SMTP

L'expéditeur doit être sur un domaine vérifié. Limites : 10 Mo par message, 50 destinataires, 300 messages par minute par identifiant.

Un assistant IA comme Claude peut utiliser Smartletter via le serveur MCP à l'adresse https://smartletter.ai/mcp.

1. Ajoute cette adresse comme connecteur dans ton assistant.
2. Connecte-toi à Smartletter quand on te le demande.
3. Vérifie les permissions et clique sur Autoriser.

Les outils couvrent : newsletters (écrire, tester, programmer, envoyer, mettre en pause, gagnant A/B, stats), contacts et imports, champs, filtres, topics, exclusions, lead magnets et formulaires d'inscription, séquences, modèles, emails transactionnels, archive, sous-domaine perso, webhooks, sites, boîte de réception, analytics, équipe et liens de facturation.