API courriel pour le Canada
Envoyez et recevez des courriels sur votre propre domaine
Les courriels transactionnels à l’envoi et les réponses au retour, avec le même compte et les mêmes clés API que vos SMS. Un courriel commercial ne part qu’avec un consentement LCAP au dossier, et vos données sont stockées au Canada.

À quoi ça sert
Les courriels que votre application envoie, et les réponses qu’elle reçoit.
- Reçus et courriels de compte
- Les reçus, les réinitialisations de mot de passe et les avis partent comme courriels transactionnels, sans paperasse de consentement.
- Réponses et courriel entrant
- Vos clients répondent à un reçu ou écrivent à une adresse de soutien, et chaque message arrive dans votre application par l’API, en JSON.
- Courriel commercial, avec consentement
- Les infolettres et les offres ne partent qu’avec un consentement LCAP au dossier, chacune à un seul destinataire, avec le lien de désabonnement ajouté pour vous.
- Avec vos SMS
- Le même compte, les mêmes clés API, les mêmes points de terminaison de webhook et le même solde prépayé que vos textos.
Envoyer depuis votre propre domaine
Ajoutez un domaine, publiez les enregistrements DNS que l’API vous donne, et envoyez.
- Votre domaine, vérifié
- DKIM sur votre domaine et une adresse de retour sur un sous-domaine d’envoi. Rien ne change dans la configuration courriel actuelle de votre domaine racine.
- Un appel ou un lot
- Envoyez un courriel à 50 destinataires au plus en to, cc et bcc, un lot de 100 courriels différents au plus, ou un même message à 500 destinataires au plus, chacun avec ses variables.
- Gabarits avec versions
- Stockez des gabarits avec des variables déclarées. Les modifications restent des brouillons jusqu’à la publication, chaque publication crée une version numérotée, et revenir en arrière prend un seul appel.
- Programmation
- Programmez un envoi de 1 minute à 30 jours à l’avance, puis déplacez-le ou annulez-le tant qu’il attend. L’annulation rembourse le montant.
- Pièces jointes
- Jusqu’à 10 fichiers et 25 Mo par courriel, les 2 premiers Mo par destinataire inclus. Les fichiers exécutables et les scripts sont refusés.
- Suivi des ouvertures et des clics
- Activez ou désactivez le suivi par domaine, et recevez la première ouverture et le premier clic par webhook.
- Nouvelles tentatives sans risque
- Envoyez un en-tête Idempotency-Key : une requête reprise renvoie le courriel d’origine au lieu de l’envoyer, et de le facturer, deux fois.
curl -X POST https://api.honkio.ca/v1/emails \
-H "Authorization: Bearer mk_test_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"from": "Acme <onboarding@test.honkio.ca>",
"to": "delivered@test.honkio.ca",
"subject": "Your receipt",
"html": "<p>Thanks for your order.</p>"
}'Cette requête fonctionne avec une clé de test avant d’ajouter un domaine : l’expéditeur et l’adresse de test n’exigent aucun DNS, et rien n’est livré ni facturé.
Recevoir des courriels
Le courriel entrant arrive par webhook et se lit par l’API, avec la clé qui vous sert déjà à envoyer.
- Une adresse gérée, prête tout de suite
- Chaque compte reçoit une adresse de réception sans rien à configurer, et n’importe quel nom avant le @ y parvient.
- Ou votre propre domaine
- Activez la réception sur un domaine dont vous envoyez déjà et publiez un seul enregistrement MX. Un sous-domaine laisse vos boîtes principales où elles sont.
- Analysé pour vous
- Chaque message déclenche un webhook email.received. Récupérez son texte, son HTML, ses en-têtes, ses pièces jointes et ses verdicts SPF, DKIM, DMARC et pourriel en JSON, ou le message brut.
- Prêt à afficher
- Demandez un HTML assaini, sans scripts ni balisage dangereux, avec les images distantes mises de côté.
- Répondre dans le fil
- Envoyez votre réponse avec les en-têtes In-Reply-To et References, et elle s’affiche dans le même fil chez votre client.
- Des plafonds qui protègent votre solde
- Jusqu’à 1 000 messages reçus par jour par défaut. Le courriel au-delà du plafond, celui signalé comme virus et celui que votre solde ne peut pas payer sont conservés en en-têtes seulement et ne sont pas facturés.
- Agents IA, sur demande
- Le serveur MCP ne lit la boîte de réception que si vous l’activez, et marque chaque champ écrit par l’expéditeur comme contenu non fiable.
LCAP et délivrabilité, gérées par l’API
Le courriel est transactionnel par défaut. Marquer un envoi comme commercial active les règles de consentement.
- Un courriel commercial (is_commercial à true) exige un consentement LCAP au dossier pour son unique destinataire. Sans consentement, l’envoi est refusé avec le code HTTP 451 et rien n’est facturé.
- Le courriel commercial reçoit un pied de page de désabonnement et le désabonnement en un clic (RFC 8058). Un désabonnement bloque le courriel commercial vers cette adresse; les reçus et les réinitialisations passent toujours.
- Les rebonds définitifs et les plaintes pour pourriel ajoutent l’adresse à votre liste de suppression, et plus aucun courriel n’y est envoyé à moins que vous ne la retiriez.
- Si vos courriels récents en direct rebondissent ou suscitent des plaintes à un taux élevé, l’envoi en direct est suspendu 24 heures et un webhook en donne la raison. Les SMS et les clés de test continuent de fonctionner.
- Le consentement est enregistré une fois par adresse courriel, dans les mêmes dossiers de consentement que vos SMS.
LCAP et suppressions, dans la documentationComment s’appliquent la LCAP, la LPRPDE et la Loi 25
Un mode test qui se comporte comme le vrai
Construisez toute l’intégration avant de toucher au DNS.
- Envoyez depuis onboarding@test.honkio.ca avec une clé de test, sans domaine. Rien n’est livré ni facturé.
- Envoyez à delivered@, bounced@, complained@ ou delayed@test.honkio.ca et voyez chaque résultat arriver par webhook.
- Simulez un courriel entrant vers votre adresse de test, avec pièces jointes et verdicts, pour construire d’abord la réception.
Des prix en dollars canadiens
Prélevés sur le même solde prépayé que les SMS, sans forfait, contrat ni minimum mensuel.
- Courriel envoyé
- 0,0025 $ CAD par destinataire2,50 $ par 1 000 destinataires, 2 Mo de pièces jointes inclus par destinataire.
- Courriel reçu
- 0,0025 $ CAD par messageCouvre le premier Mo de chaque message, puis 0,002 $ par Mo entamé. Le courriel bloqué comme virus ou au-delà de votre plafond quotidien est gratuit.
Un destinataire refusé faute de consentement, pour un désabonnement ou une suppression ne coûte rien, et le mode test est toujours gratuit. L’adresse de réception gérée est gratuite : vous ne payez que les messages qu’elle accepte.
Où vos données sont stockées
Les courriels envoyés et reçus, les domaines d’envoi, les consentements et les listes de suppression sont stockés au Canada, dans la région AWS ca-central-1 (Montréal).
Le contenu des courriels est purgé 90 jours après l’envoi ou la réception. Le message brut et les pièces jointes du courriel reçu sont conservés 40 jours.
Les requêtes API sont traitées sur une infrastructure hébergée aux États-Unis avant d’être stockées. La politique de confidentialité décrit chaque cas et qui traite les données.
SDK, cadriciels et migration
Utilisez l’API dans le langage que vous connaissez déjà.
- SDK
- Des clients officiels Node.js, Python et PHP pour envoyer des courriels et lire le courriel reçu.
- Transport de courriel Laravel
- Ajoutez un mailer honkio dans config/mail.php, et vos Mailables existants passent par HonkIO.
- Serveur MCP
- Laissez Claude, Cursor ou VS Code envoyer des courriels par le serveur MCP de HonkIO, et lire la boîte de réception si vous l’activez.
- Quitter Resend
- La plupart des intégrations changent l’URL de base et la clé. Le guide de migration liste les champs qui diffèrent, comme l’indicateur LCAP et la programmation en ISO 8601.
Documentation courriel
Chaque page existe en français et en anglais.
Questions
- Les courriels transactionnels exigent-ils un consentement au dossier?
- Pas dans HonkIO. Le courriel est transactionnel par défaut et part sans consentement au dossier. Mettez is_commercial à true sur tout envoi promotionnel : HonkIO exige alors un consentement LCAP au dossier, ajoute le pied de page de désabonnement et respecte le désabonnement en un clic.
- Puis-je recevoir des courriels sans modifier mon DNS?
- Oui. Chaque compte a une adresse de réception gérée qui fonctionne sans rien configurer. Pour recevoir sur votre propre domaine, vérifiez-le pour l’envoi et publiez un seul enregistrement MX, idéalement sur un sous-domaine.
- Comment le courriel reçu arrive-t-il dans mon application?
- Chaque message accepté déclenche un webhook email.received avec ses métadonnées. Récupérez le message complet par son id en JSON (texte, HTML, en-têtes, pièces jointes et verdicts d’authentification) ou téléchargez le message brut. La livraison se fait au moins une fois : dédoublonnez sur l’id du courriel.
- Comment le courriel est-il facturé?
- Par destinataire accepté à l’envoi et par message accepté à la réception, sur le même solde prépayé que les SMS. Un destinataire refusé avant l’envoi n’est pas facturé, et le mode test est gratuit.
- Ajouter mon domaine change-t-il le courriel que je reçois déjà?
- Non. L’envoi utilise DKIM sur votre domaine et une adresse de retour sur un sous-domaine d’envoi : les enregistrements MX et les boîtes de votre domaine racine restent tels quels. La réception sur votre domaine est une étape distincte, que vous activez.
- Que se passe-t-il si mes courriels se mettent à rebondir?
- Les rebonds définitifs et les plaintes sont supprimés automatiquement. Si plus de 5 % de vos 200 derniers courriels en direct rebondissent définitivement (après au moins 50 envois), ou si plus de 0,1 % de vos 1 000 derniers suscitent des plaintes, l’envoi en direct est suspendu 24 heures et vous recevez un webhook account.sending_paused et un courriel. Les SMS continuent de partir.
- Où mes courriels sont-ils stockés?
- Au Canada, dans la région AWS ca-central-1 (Montréal). Le contenu est purgé après 90 jours, et les pièces jointes et le message brut du courriel reçu après 40. Les requêtes API sont traitées sur une infrastructure hébergée aux États-Unis avant d’être stockées.
- J’utilise Resend en ce moment. Qu’est-ce qui doit changer?
- Pour la plupart des intégrations, l’URL de base et la clé API; avec le SDK, importez Honkio de @honkio/node à la place de Resend. Le guide de migration couvre les champs qui diffèrent, comme is_commercial pour la LCAP et la programmation en ISO 8601.
À lire aussi
- API SMS
Envoyez et recevez des SMS avec des numéros canadiens locaux et sans frais, avec le consentement LCAP et les réponses STOP appliqués par l’API.
- Agents IA et MCP
Un serveur MCP qui permet aux agents IA d’envoyer des SMS, de vérifier des numéros, d’acheter des numéros canadiens et de vérifier le consentement LCAP par HonkIO.
- HonkIO vs fournisseurs de courriel américains
Une API courriel pour les expéditeurs canadiens : courriels envoyés et reçus stockés au Canada, désabonnement LCAP intégré, prix en CAD.
- HonkIO ou Resend
HonkIO et Resend comparés pour les courriels à des gens au Canada : tarifs, réception de courriels, stockage des données et désabonnement LCAP.
- HonkIO ou SendGrid
HonkIO et Twilio SendGrid comparés pour les courriels à des gens au Canada : forfaits et prix, réception de courriels, résidence des données et désabonnement.
- HonkIO ou Postmark
HonkIO et Postmark comparés pour les courriels à des gens au Canada : prix en CAD et en USD, réception de courriels, stockage des données et désabonnement.
- HonkIO ou Mailgun
HonkIO et Mailgun comparés pour les courriels à des gens au Canada : forfaits en USD et prix en CAD, routes de réception, régions É.-U. et UE, et désabonnement.
- La LCAP pour les développeurs
Ce que la loi anti-pourriel exige du code qui envoie des textos et des courriels : consentement, identification, désabonnement et registres.
Essayez d'abord en mode test
Les clés de test fonctionnent dès l'inscription, sans carte et sans frais.