Doc Partner
SMS PartnerVoice PartnerMail PartnerSDKS
Doc Partner - FR
Doc Partner - FR
  • Bienvenue
  • API
    • SMS Partner
      • Crédits
      • Envoyer des SMS
        • Envoi unitaire
        • Envoi par lots
        • Envoi par numéro long
        • Envoi de sondages
        • Annuler l'envoi d'un SMS différé
        • Caractères spéciaux
      • Statut & Statistiques
        • Statut unitaire
        • Statut multiple
        • Statut par message
        • Statut par tag
        • Statistique des envois
      • Gestion des contacts
        • Ajouter un groupe
        • Ajouter un contact
        • Supprimer un groupe
        • Ajouter un lot de contacts
        • Modifier un contact
        • Supprimer un contact
        • Obtenir la liste des groupes
        • Obtenir la liste des contacts
        • Obtenir le détail d'un contact
      • Gestion des réponses / stops
        • Liste des stops
        • Ajouter un numéro au stop SMS
        • Supprimer un numéro du STOP SMS
        • Gestion des réponses
      • Sous-comptes
        • Activation
        • Création d'un sous compte
        • Supprimer un sous-compte
        • Liste des sous-comptes
        • Gérer les crédits des sous-comptes
      • Gérer le transfert d'appel
      • Vérification de numéros
        • Envoyer une vérification
        • Vérification de format
      • Location de contacts
        • Catégories
        • Ciblage et calcul
        • Statut d'une location
        • Télécharger le fichier
      • RCS
    • Voice Partner
      • Crédits
      • Message Vocal
        • Liste des fichiers audio
        • Renommer un fichier audio
        • Déposer un message vocal
      • Envoyer un SMS Vocal
      • Supprimer un envoi différé
    • Mail Partner
      • Crédits
      • Envoi unitaire de mail
      • Annuler l'envoi d'un mail
      • Statut par message
      • Gestion des désabonnements
        • Ajouter un mail
        • Liste des désabonnements
        • Supprimer un mail
      • Sous-comptes
        • Activation
        • Création d'un sous compte
        • Liste des sous-comptes
        • Gérer les crédits des sous-comptes
    • Codes d'erreur
  • SDKS
Propulsé par GitBook

© 2025 NDA Media

Sur cette page
  1. API
  2. Mail Partner

Envoi unitaire de mail

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

PrécédentCréditsSuivantAnnuler l'envoi d'un mail

Dernière mise à jour il y a 28 jours

URL

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

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 :

Paramètres obligatoires

Nom
Valeur

apiKey

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

From

Adresse email émetteur de l'envoi email: email name (optionnel) : Nom

to

Vous pouvez ajouter jusqu’a 500 destinataires :

Paramètres optionnels

Nom
Valeur

replyTo

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.

filename : Nom de la pièce jointe (sans extension)

contentType : Type mime de la pièce jointe.

Exemple JSON complet :

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

1 pour 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

json ou xml

Requête

<?php
        // Prepare data for POST request
        $jsonParams = "{
       "apiKey": "Your API kEY",
       "subject": "Sujet de mon email",
       "sandbox":0,
       "htmlContent": "Mon premier <strong>email</strong>",
       "scheduledDeliveryDate":"25/09/2020",
       "time":"12",
       "minute":"00",
       "from": {
          "name" :"Marie",
          "email": "monemail@email.com"    
       },
       "to": [
          {
              "email": "email1"
          },
          {
              "emai": "email2"
          }
        ]
       }"
 
        $curl = curl_init();
        curl_setopt($curl, CURLOPT_URL,'http://api.mailpartner.fr/v1/send');
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($curl, CURLOPT_TIMEOUT, 10);
        curl_setopt($curl, CURLOPT_POST, 1);
        curl_setopt($curl, CURLOPT_POSTFIELDS, $jsonParams);
 
        $result = curl_exec($curl);
        curl_close($curl);
 
        // Process your response here
        echo $result;
?>

Réponse

{
    "success": true,
    "code": 200,
    "messageId": "xxx",
    "nbMail": 1,
    "cost": 1,
    "currency": "EUR",
    "scheduledDeliveryDate": "2020-09-25 12:00:00"
}

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

email

Email du destinataire

name (optionnel)

Nom du destinataire

email

Email

name (optionnel)

Nom

{
  "attachments": [
    {
      "base64Content": "VGhpcyBpcyB5b3VyIGF0dGFjaGVkIGZpbGUhISEK",
      "contentType": "text/plain",
      "filename": "test"
    }
  ]
}
help@mailpartner.fr
Votre clé API
ici
ici