Envoyer
Envoi d’e-mails
Envoyez en toute sécurité des messages transactionnels, des lots, des réponses, des pièces jointes et des modèles hébergés.
Contenu du message
Fournissez une identité from sur un domaine vérifié de l’espace de travail, au moins un destinataire to, et du HTML, du texte ou un modèle hébergé publié. Un envoi de contenu brut peut omettre subject, ce qui produit un objet vide. SendHQ génère au besoin une alternative en texte brut à partir du HTML, mais une alternative rédigée par vos soins est plus fiable.
Destinataires et crédits
Un message peut contenir au maximum 100 destinations To, Cc et Bcc cumulées. Chaque destination consomme un crédit de livraison par destinataire. Les adresses de destinataires en double, une fois normalisées, ne sont vérifiées qu’une fois contre les suppressions, mais chaque destination compte quand même dans les limites du message.
Nouvelles tentatives sûres
Envoyez une Idempotency-Key stable d’au plus 200 caractères lors des envois unitaires et par lot. Réutiliser une clé avec un payload JSON identique rejoue la réponse enregistrée et ajoute Idempotent-Replayed: true. Modifier un destinataire, le contenu, un en-tête ou les données du modèle avec la même clé renvoie 409 ; une requête concurrente avec cette clé renvoie aussi 409 tant que la première est en cours.
Envoi par lot
POST /emails/batch accepte jusqu’à 100 objets message et renvoie un résultat pour chaque position. Utilisez des objets message distincts pour les données de modèle personnalisées plutôt que d’envoyer un seul modèle personnalisé à plusieurs destinataires.
Réponses et fils de discussion
Définissez reply_to_email_id lorsque vous répondez. SendHQ en déduit Message-ID, In-Reply-To, References et l’identifiant du fil existant. Récupérez la conversation complète avec GET /threads/:id.