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.
bash
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.

Recevoir des courriels, dans la documentation

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.

Tous les prixLimites du courriel, dans la documentation

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.

Lire la politique de confidentialité

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.

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

Créer un compte gratuit

Les clés de test fonctionnent dès l'inscription, sans carte et sans frais.