Courriels

Votre adresse de réception gérée

Réponses

• 200L’adresse de réception gérée du compte (n’importe quoi@… y aboutit), créée au premier appel puis stable. enabled active ou désactive l’adresse gérée : les courriels qui y sont envoyés pendant qu’elle est désactivée sont supprimés, sans frais.›

  Champ	Type	Description
  domainobligatoire	string
  exampleobligatoire	string
  livemodeobligatoire	boolean
  enabledobligatoire	boolean
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403ACCOUNT_NOT_VERIFIED : l’adresse gérée de production nécessite un numéro mobile du propriétaire vérifié. Une clé de test n’est jamais refusée ; elle crée et renvoie toujours l’adresse de test. Également FORBIDDEN lorsque la clé n’a pas la permission requise par cette opération, ou que le compte est suspendu ou fermé.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

const { data: address, error } = await honkio.emails.received.address()
if (error) throw new Error(error.message)
console.log(address.example)

curl https://api.honkio.ca/v1/emails/received/address \
  -H "Authorization: Bearer mk_live_YOUR_KEY"

Activer ou désactiver votre adresse de réception gérée (clés de production seulement)

Corps de la requête

Réponses

• 200Le même objet d’adresse que celui renvoyé par GET, avec enabled défini sur la valeur demandée. Ce paramètre s’applique à tout le compte : le désactiver empêche l’adresse gérée de production de recevoir des courriels ; seule une clé de production peut donc le modifier.›

  Champ	Type	Description
  domainobligatoire	string
  exampleobligatoire	string
  livemodeobligatoire	boolean
  enabledobligatoire	boolean
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403LIVE_KEY_REQUIRED : ce réglage s’applique à tout le compte et désactive l’adresse de production, de sorte qu’une clé de test ne peut pas le modifier (GET l’indique tout de même). Aussi ACCOUNT_NOT_VERIFIED (un numéro mobile du propriétaire vérifié est requis) ou FORBIDDEN lorsque la clé ne dispose pas de emails:m.Le corps d’erreur standard.
• 422VALIDATION_ERROR : la requête n’a pas passé la validation ; details indique les champs en cause.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

const { data, error } = await honkio.emails.received.setAddressEnabled(false)
if (error) throw new Error(error.message)
console.log(data.enabled)

curl -X PATCH https://api.honkio.ca/v1/emails/received/address \
  -H "Authorization: Bearer mk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": false
  }'

Lister les courriels reçus

Réponses

• 200Une page de courriels reçus, du plus récent au plus ancien.›

  Champ	Type	Description
  data[]obligatoire	object[]
  idobligatoire	string
  fromobligatoire	string
  from_nameobligatoire	string	Peut être null
  toobligatoire	string[]
  ccobligatoire	string[]
  subjectobligatoire	string
  message_idobligatoire	string	Peut être null
  in_reply_toobligatoire	string	Peut être null
  received_atobligatoire	string	Format : date-time
  statusobligatoire	string	Une valeur parmi : received | rejected
  reject_reasonobligatoire	string	Peut être null
  verdictsobligatoire	object
  spfobligatoire	string
  dkimobligatoire	string
  dmarcobligatoire	string
  spamobligatoire	string
  virusobligatoire	string
  attachments_countobligatoire	integer
  size_bytesobligatoire	integer
  charge_millicentsobligatoire	integer
  domain_idobligatoire	string	Peut être null
  livemodeobligatoire	boolean
  has_moreobligatoire	boolean
  next_cursorobligatoire	string	Peut être null
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403La clé API ne dispose pas de la permission requise pour cette opération, ou le compte est suspendu ou fermé.Le corps d’erreur standard.
• 422VALIDATION_ERROR : la requête n’a pas passé la validation ; details indique les champs en cause.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

const { data, error } = await honkio.emails.received.list({ limit: 10 })
if (error) throw new Error(error.message)
for (const email of data.data) console.log(email.id, email.from, email.subject)

curl https://api.honkio.ca/v1/emails/received \
  -H "Authorization: Bearer mk_live_YOUR_KEY"

Simuler un courriel reçu (clés de test uniquement)

Corps de la requête

Réponses

• 201Le message simulé, sous la même forme que la réponse de GET /v1/emails/received/:id. livemode est toujours false.›

  Champ	Type	Description
  idobligatoire	string
  fromobligatoire	string
  from_nameobligatoire	string	Peut être null
  toobligatoire	string[]
  ccobligatoire	string[]
  subjectobligatoire	string
  message_idobligatoire	string	Peut être null
  in_reply_toobligatoire	string	Peut être null
  received_atobligatoire	string	Format : date-time
  statusobligatoire	string	Une valeur parmi : received | rejected
  reject_reasonobligatoire	string	Peut être null
  verdictsobligatoire	object
  spfobligatoire	string
  dkimobligatoire	string
  dmarcobligatoire	string
  spamobligatoire	string
  virusobligatoire	string
  attachments_countobligatoire	integer
  size_bytesobligatoire	integer
  charge_millicentsobligatoire	integer
  domain_idobligatoire	string	Peut être null
  livemodeobligatoire	boolean
  textobligatoire	string	Peut être null
  htmlobligatoire	string	Peut être null
  html_formatobligatoire	string	Une valeur parmi : cid | links | sanitized
  remote_imagesobligatoire	integer	Images distantes mises de côté dans data-remote-src par html_format=sanitized ; null pour les autres formats. Peut être null
  headers[]obligatoire	object[]
  nameobligatoire	string
  valueobligatoire	string
  referencesobligatoire	string[]
  reply_toobligatoire	string[]
  envelope_recipientsobligatoire	string[]
  body_purgedobligatoire	boolean
  body_truncatedobligatoire	boolean	text ou html a été tronqué à 2 Mo (octets UTF-8) lors du stockage ; le message brut le conserve en entier.
  raw_availableobligatoire	boolean
  parse_failedobligatoire	boolean
  attachments_bytesobligatoire	integer	Taille totale des pièces jointes, en octets.
  attachments[]obligatoire	object[]
  idobligatoire	string
  filenameobligatoire	string
  content_typeobligatoire	string
  content_idobligatoire	string	Peut être null
  inlineobligatoire	boolean
  size_bytesobligatoire	integer
  expires_atobligatoire	string	Format : date-time
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403TEST_KEY_REQUIRED : ce point de terminaison n’accepte que les clés de test.Le corps d’erreur standard.
• 422VALIDATION_ERROR (entrée invalide, ou pièces jointes de plus de 10 Mo au total) ou SIMULATE_RECIPIENT_NOT_OWNED (une adresse to/cc n’est ni l’adresse gérée de test du compte ni l’un de ses propres domaines en mode test).Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

// Test keys only: no real sender involved.
const { data, error } = await honkio.emails.received.simulate({
  from: 'sam@example.com',
  to: ['support@yourdomain.ca'],
  subject: 'Where is my order?',
  text: 'Hi, it has been a week.',
})
if (error) throw new Error(error.message)
console.log(data.id)

curl -X POST https://api.honkio.ca/v1/emails/received/simulate \
  -H "Authorization: Bearer mk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "sam@example.com",
    "to": [
      "support@yourdomain.ca"
    ],
    "subject": "Where is my order?",
    "text": "Hi, it has been a week."
  }'

Obtenir un courriel reçu

Paramètres

Réponses

• 200Le courriel reçu. html est réécrit pour que les images cid: pointent vers la route de la pièce jointe, sauf si html_format=cid demande l’original ; html_format=sanitized retire également les scripts et le balisage potentiellement dangereux, et place les images distantes dans data-remote-src (leur nombre figure dans remote_images).›

  Champ	Type	Description
  idobligatoire	string
  fromobligatoire	string
  from_nameobligatoire	string	Peut être null
  toobligatoire	string[]
  ccobligatoire	string[]
  subjectobligatoire	string
  message_idobligatoire	string	Peut être null
  in_reply_toobligatoire	string	Peut être null
  received_atobligatoire	string	Format : date-time
  statusobligatoire	string	Une valeur parmi : received | rejected
  reject_reasonobligatoire	string	Peut être null
  verdictsobligatoire	object
  spfobligatoire	string
  dkimobligatoire	string
  dmarcobligatoire	string
  spamobligatoire	string
  virusobligatoire	string
  attachments_countobligatoire	integer
  size_bytesobligatoire	integer
  charge_millicentsobligatoire	integer
  domain_idobligatoire	string	Peut être null
  livemodeobligatoire	boolean
  textobligatoire	string	Peut être null
  htmlobligatoire	string	Peut être null
  html_formatobligatoire	string	Une valeur parmi : cid | links | sanitized
  remote_imagesobligatoire	integer	Images distantes mises de côté dans data-remote-src par html_format=sanitized ; null pour les autres formats. Peut être null
  headers[]obligatoire	object[]
  nameobligatoire	string
  valueobligatoire	string
  referencesobligatoire	string[]
  reply_toobligatoire	string[]
  envelope_recipientsobligatoire	string[]
  body_purgedobligatoire	boolean
  body_truncatedobligatoire	boolean	text ou html a été tronqué à 2 Mo (octets UTF-8) lors du stockage ; le message brut le conserve en entier.
  raw_availableobligatoire	boolean
  parse_failedobligatoire	boolean
  attachments_bytesobligatoire	integer	Taille totale des pièces jointes, en octets.
  attachments[]obligatoire	object[]
  idobligatoire	string
  filenameobligatoire	string
  content_typeobligatoire	string
  content_idobligatoire	string	Peut être null
  inlineobligatoire	boolean
  size_bytesobligatoire	integer
  expires_atobligatoire	string	Format : date-time
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403La clé API ne dispose pas de la permission requise pour cette opération, ou le compte est suspendu ou fermé.Le corps d’erreur standard.
• 404RECEIVED_EMAIL_NOT_FOUND : aucun courriel reçu portant cet identifiant dans ce compte. Une clé de test ne trouve que les messages reçus à l’adresse gérée de test.Le corps d’erreur standard.
• 422VALIDATION_ERROR : html_format ne vaut ni cid, ni links, ni sanitized.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

const { data: email, error } = await honkio.emails.received.get('RECEIVED_EMAIL_ID')
if (error) throw new Error(error.message)
console.log(email.from, email.subject, email.text)

curl https://api.honkio.ca/v1/emails/received/ID \
  -H "Authorization: Bearer mk_live_YOUR_KEY"

Télécharger le MIME brut d’un courriel reçu

Paramètres

Réponses

• 200Le message MIME brut, exactement tel qu’il a été reçu.
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403La clé API ne dispose pas de la permission requise pour cette opération, ou le compte est suspendu ou fermé.Le corps d’erreur standard.
• 404RECEIVED_EMAIL_NOT_FOUND : aucun courriel reçu portant cet identifiant dans ce compte. Une clé de test ne trouve que les messages reçus à l’adresse gérée de test.Le corps d’erreur standard.
• 410ATTACHMENT_EXPIRED : le message brut ou la pièce jointe n’est plus conservé (durée de conservation de 40 jours).Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

const { data: mime, error } = await honkio.emails.received.raw('RECEIVED_EMAIL_ID')
if (error) throw new Error(error.message)
console.log(await mime.text())

curl https://api.honkio.ca/v1/emails/received/ID/raw \
  -H "Authorization: Bearer mk_live_YOUR_KEY"

Télécharger une pièce jointe reçue

Paramètres

Réponses

• 200Les octets de la pièce jointe, avec l’en-tête Content-Disposition défini sur le nom de fichier d’origine.
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403La clé API ne dispose pas de la permission requise pour cette opération, ou le compte est suspendu ou fermé.Le corps d’erreur standard.
• 404RECEIVED_EMAIL_NOT_FOUND : aucun courriel reçu portant cet identifiant dans ce compte. Une clé de test ne trouve que les messages reçus à l’adresse gérée de test.Le corps d’erreur standard.
• 410ATTACHMENT_EXPIRED : le message brut ou la pièce jointe n’est plus conservé (durée de conservation de 40 jours).Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

const { data: file, error } = await honkio.emails.received.attachment('RECEIVED_EMAIL_ID', 'ATTACHMENT_ID')
if (error) throw new Error(error.message)
const bytes = new Uint8Array(await file.arrayBuffer())
console.log(bytes.length)

curl https://api.honkio.ca/v1/emails/received/ID/attachments/ATTACHMENT_ID \
  -H "Authorization: Bearer mk_live_YOUR_KEY"

Lister les courriels

Paramètres

Réponses

• 200Une page de courriels envoyés dans le mode de la clé appelante (une clé de production ne liste jamais un envoi de test, ni une clé de test un envoi réel), du plus récent au plus ancien.›

  Champ	Type	Description
  data[]obligatoire	object[]
  idobligatoire	string
  fromobligatoire	string
  toobligatoire	string[]
  subjectobligatoire	string
  body_purged_atobligatoire	string	Défini une fois l’objet et le corps purgés par la politique de conservation. Format : date-time Peut être null
  statusobligatoire	string	Une valeur parmi : queued | scheduled | sending | sent | delivered | bounced | complained | rejected | failed | cancelled
  ses_message_idobligatoire	string	Peut être null
  is_commercialobligatoire	boolean
  attachments_countobligatoire	integer
  livemodeobligatoire	boolean
  tags[]obligatoire	object[]
  nameobligatoire	string
  valueobligatoire	string
  created_atobligatoire	string	Format : date-time
  has_moreobligatoire	boolean
  next_cursorobligatoire	string	Peut être null
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403La clé API ne dispose pas de la permission requise pour cette opération, ou le compte est suspendu ou fermé.Le corps d’erreur standard.
• 422VALIDATION_ERROR : la requête n’a pas passé la validation ; details indique les champs en cause.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

const { data, error } = await honkio.emails.list({ status: 'bounced', limit: 20 })
if (error) throw new Error(error.message)
for (const email of data.data) console.log(email.id, email.to)

curl https://api.honkio.ca/v1/emails \
  -H "Authorization: Bearer mk_live_YOUR_KEY"

Envoyer un courriel

Corps de la requête

Réponses

• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403FORBIDDEN (la clé n’a pas l’autorisation emails:w), EMAIL_DOMAIN_NOT_ALLOWED (cette clé ne peut pas envoyer depuis ce domaine) ou SENDING_PAUSED (l’envoi réel de courriels est mis en pause pour ce compte à la suite d’un taux élevé de rebonds ou de plaintes ; details contient paused_until, reason et channel: "email"). Les clés de test ne sont jamais mises en pause.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

const { data, error } = await honkio.emails.send({
  from: 'Acme <hello@yourdomain.ca>',
  to: 'sam@example.com',
  subject: 'Your receipt',
  html: '<p>Thanks for your order, Sam.</p>',
})
if (error) throw new Error(`${error.name}: ${error.message}`)
console.log(data.id, data.status)

curl -X POST https://api.honkio.ca/v1/emails \
  -H "Authorization: Bearer mk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@yourdomain.ca>",
    "to": "sam@example.com",
    "subject": "Your receipt",
    "html": "<p>Thanks for your order, Sam.</p>"
  }'

Obtenir un courriel par identifiant

Paramètres

Réponses

• 200Le courriel envoyé, avec la chronologie de ses événements.›

  Champ	Type	Description
  idobligatoire	string
  fromobligatoire	string
  toobligatoire	string[]
  subjectobligatoire	string
  body_purged_atobligatoire	string	Défini une fois l’objet et le corps purgés par la politique de conservation. Format : date-time Peut être null
  statusobligatoire	string	Une valeur parmi : queued | scheduled | sending | sent | delivered | bounced | complained | rejected | failed | cancelled
  ses_message_idobligatoire	string	Peut être null
  is_commercialobligatoire	boolean
  attachments_countobligatoire	integer
  livemodeobligatoire	boolean
  tags[]obligatoire	object[]
  nameobligatoire	string
  valueobligatoire	string
  created_atobligatoire	string	Format : date-time
  from_nameobligatoire	string	Peut être null
  ccobligatoire	string[]
  bccobligatoire	string[]
  htmlobligatoire	string	Peut être null
  textobligatoire	string	Peut être null
  templateobligatoire	any | object
  attachments[]obligatoire	object[]
  filenameobligatoire	string
  content_typeobligatoire	string
  content_idobligatoire	string	Peut être null
  size_bytesobligatoire	integer
  cost_centsobligatoire	integer	Nombre de cents entiers débités du solde pour cet envoi ; souvent 0 pour un seul courriel à une fraction de cent.
  charge_millicentsobligatoire	integer	Le prix exact consommé par l’envoi, en millicents CAD.
  attachment_bytesobligatoire	integer	Nombre total d’octets de pièces jointes sur lequel les frais ont été calculés.
  scheduled_atobligatoire	string	Format : date-time Peut être null
  updated_atobligatoire	string	Format : date-time
  events[]obligatoire	object[]
  typeobligatoire	string
  occurred_atobligatoire	string	Format : date-time
  payloadobligatoire	any
• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403La clé API ne dispose pas de la permission requise pour cette opération, ou le compte est suspendu ou fermé.Le corps d’erreur standard.
• 404NOT_FOUND (details.resource "email") : aucun courriel portant cet id sur ce compte dans le mode de la clé appelante. Une clé de test ne trouve que les envois de test, une clé de production que les envois réels.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

const { data, error } = await honkio.emails.get('EMAIL_ID')
if (error) throw new Error(error.message)
console.log(data.status, data.events)

curl https://api.honkio.ca/v1/emails/ID \
  -H "Authorization: Bearer mk_live_YOUR_KEY"

Reprogrammer un courriel programmé

Paramètres

Corps de la requête

Réponses

• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403La clé API ne dispose pas de la permission requise pour cette opération, ou le compte est suspendu ou fermé.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

const { data, error } = await honkio.emails.update('EMAIL_ID', { scheduledAt: '2026-10-01T14:00:00Z' })
if (error) throw new Error(error.message)
console.log(data.scheduled_at)

curl -X PATCH https://api.honkio.ca/v1/emails/ID \
  -H "Authorization: Bearer mk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scheduled_at": "2026-10-01T14:00:00Z"
  }'

Annuler un courriel programmé

Paramètres

Réponses

• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403La clé API ne dispose pas de la permission requise pour cette opération, ou le compte est suspendu ou fermé.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

const { error } = await honkio.emails.cancel('EMAIL_ID')
if (error) throw new Error(error.message)

curl -X DELETE https://api.honkio.ca/v1/emails/ID \
  -H "Authorization: Bearer mk_live_YOUR_KEY"

Effectuer un envoi groupé de courriels

Corps de la requête

Réponses

• 401Clé API manquante, invalide, révoquée ou expirée.Le corps d’erreur standard.
• 402Le compte n’a aucun solde, ou une clé LIVE a été utilisée avant la première recharge.Le corps d’erreur standard.
• 403FORBIDDEN, EMAIL_DOMAIN_NOT_ALLOWED ou SENDING_PAUSED (l’envoi réel de courriels est mis en pause ; details contient paused_until, reason et channel: "email"). Refusé avant l’envoi de tout élément.Le corps d’erreur standard.
• 429Limite de débit atteinte : 100 requêtes par seconde et par compte, ou une limite propre à la route (Retry-After est défini le cas échéant).Le corps d’erreur standard.
• 500Erreur de serveur inattendue.Le corps d’erreur standard.

Exemple

const { data, error } = await honkio.batch.send([
  { from: 'Acme <hello@yourdomain.ca>', to: 'sam@example.com', subject: 'Your receipt', html: '<p>Thanks, Sam.</p>' },
  { from: 'Acme <hello@yourdomain.ca>', to: 'alex@example.com', subject: 'Your receipt', html: '<p>Thanks, Alex.</p>' },
])
if (error) throw new Error(error.message)
console.log(data.batch_id, data.data.length)

curl -X POST https://api.honkio.ca/v1/emails/batch \
  -H "Authorization: Bearer mk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "from": "Acme <hello@yourdomain.ca>",
      "to": "sam@example.com",
      "subject": "Your receipt",
      "html": "<p>Thanks, Sam.</p>"
    },
    {
      "from": "Acme <hello@yourdomain.ca>",
      "to": "alex@example.com",
      "subject": "Your receipt",
      "html": "<p>Thanks, Alex.</p>"
    }
  ]'