Envoyer des mails

Cette requête est utilisée pour envoyer des mails en temps réel ou en différé.

URL

POST http://api.mailpartner.fr/v1/send

Paramètres

Chaque demande d’API prend en charge les paramètres suivants :

  • La plateforme n’envoie pas de mails commerciaux entre 20h et 8h en semaine et les dimanches et jours fériés (restriction légale). Si un message mail est envoyé, le message est en pause jusqu’au prochain jour ouvrable à 8h.
  • Vous n’envoyez pas de mails commerciaux? contactez-nous pour désactiver cette restriction : help@mailpartner.fr
apiKey Clé API de votre compte. Vous l’obtenez dans votre compte Mail Partner.
subject Sujet du mail
htmlContent Contenu du mail en HTML.

Le tag #READ_ONLINE# ajoute le lien “Si cet e-mail ne s’affiche pas correctement, veuillez utiliser le lien suivant :”
Le tag #UNSUBSCRIBE_LINK# ajoute le lien de désinscription

to Vous pouvez ajouter jusqu’a 500 destinataires

email Email du destinataire
name (optionnel) Nom du destinataire
Paramètres optionnels
replyTo
email Email
name (optionnel) Nom
variables Vous pouvez ajouter jusqu’a 8 variables personnalisées contenant uniquement du texte (pas de html).
Ex:
"variables":{"firstname":"John", "lastname": "Doe"}

Ces variables doivent être ajoutés dans le template ou dans htmlContent de cette manière:

#FIRSTNAME# et #LASTNAME#

attachments 3 pièces jointes Maximum. 5Mo par pièce jointe.

base64Content Le contenu doit être encodé en Base64. Vous devez également spécifier le type MIME et un nom de fichier
"attachments":
[{
"base64Content":"VGhpcyBpcyB5b3VyIGF0dGFjaGVkIGZpbGUhISEK",
"contentType":"text/plain",
"filename":"test"
}]
filename Nom de la pièce jointe (sans extension)
contentType Type mime de la pièce jointe.

Vous pouvez voir la liste officielle des types MIME ici.
Pour le contenu, vous pouvez trouver un encodeur Base64 en ligne – par exemple ici. Une fois le fichier encodé, utilisez la chaîne de caractères résultante comme valeur du contenu Base64Content.

tag Identifiant en minuscule (sans espace) entre 3 et 20 caractères
scheduledDeliveryDate Date d’envoi du mail, au format dd/mm/YYYY. A définir uniquement si vous souhaitez que les mails soient envoyés en différé.
time Heure d’envoi du mail (format 0-24), obligatoire si scheduledDeliveryDate est défini.
minute Minute d’envoi du mail (format 0-55, par intervalle de cinq minutes).
, obligatoire si scheduledDeliveryDate est défini.
sandbox Pour tester l’envoi de mail, vous pouvez utiliser le paramètre sandbox:

  • 1 pour activer le mode bac à sable

  Aucun mail ne sera envoyé, et il n’y aura aucun débit sur votre compte.
Ces mails seront supprimés de vos listes d’envois automatiquement tous les jours.

_format Format de la réponse. Vous pouvez choisir entre JSON ou XML. Par défaut, le format de réponse est JSON.

Requête

Exemple de requête :

Réponses