> For the complete documentation index, see [llms.txt](https://www.docpartner.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.docpartner.dev/api/mail-partner/envoi-unitaire.md). # Envoi unitaire de mail ## URL `POST` `https://api.mailpartner.fr/v1/send` {% hint style="warning" %} 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 : {% endhint %} #### **Paramètres obligatoires**

Nom	Valeur
`apiKey`	Votre clé API
`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 :

| `email` | Email du destinataire | | ------------------ | --------------------- | | `name` (optionnel) | Nom du destinataire | #### **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. 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. Exemple JSON complet : `{ "attachments": [ { "base64Content": "VGhpcyBpcyB5b3VyIGF0dGFjaGVkIGZpbGUhISEK", "contentType": "text/plain", "filename": "test" } ] }`
`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`

| `email` | Email | | ------------------ | ----- | | `name` (optionnel) | Nom | #### Requête {% tabs %} {% tab title="PHP" %}

<?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;
?>

{% endtab %} {% endtabs %} #### **Réponse** {% tabs %} {% tab title="json" %} ```json { "success": true, "code": 200, "messageId": "xxx", "nbMail": 1, "cost": 1, "currency": "EUR", "scheduledDeliveryDate": "2020-09-25 12:00:00" } ``` {% endtab %} {% endtabs %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://www.docpartner.dev/api/mail-partner/envoi-unitaire.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.