Exemples de code
Exemples d'envoi via Mailiqo depuis les langages et frameworks les plus courants, en SMTP ou avec l'API.
Versions vérifiées le 2 novembre 2026
Nodemailer 10.3.1, PHPMailer 7.1.1, Laravel 13 (valable aussi pour 11 et 12), Symfony 8.1 et la bibliothèque standard de Python 3. D'après la documentation officielle de chaque projet (liens à la fin).
Avant de commencer
- SMTP : hôte
smtpmq.mailiqo.com, port587avec STARTTLS (ou465avec TLS implicite), et le nom d'utilisateur et le mot de passe SMTP du domaine, depuis Email → Domaines. - API : une clé API depuis Paramètres → API et intégrations, envoyée dans l'en-tête
X-API-KEY. Voir Authentification. - L'expéditeur doit être une adresse du domaine vérifié.
- Gardez les identifiants hors du code. Les exemples les lisent depuis les variables d'environnement
MAILIQO_SMTP_USER,MAILIQO_SMTP_PASSetMAILIQO_API_KEY.
SMTP est la façon la plus rapide de connecter une application qui envoie déjà des emails. L'API renvoie le résultat par destinataire et un uuid pour suivre la livraison. Voir Vue d'ensemble SMTP et API d'envoi d'emails.
SMTP
Node.js (Nodemailer)
npm install nodemailerimport nodemailer from 'nodemailer';
const transporter = nodemailer.createTransport({
host: 'smtpmq.mailiqo.com',
port: 587,
secure: false,
requireTLS: true,
auth: {
user: process.env.MAILIQO_SMTP_USER,
pass: process.env.MAILIQO_SMTP_PASS,
},
});
const info = await transporter.sendMail({
from: '"Votre boutique" <[email protected]>',
to: '[email protected]',
subject: 'Votre commande a été expédiée',
text: 'Votre commande est en route.',
html: '<p>Votre commande est en route.</p>',
});
console.log(info.messageId);secure: false avec requireTLS: true fait que Nodemailer passe la connexion en STARTTLS et échoue s'il n'y parvient pas. Pour le port 465, utilisez port: 465 et secure: true.
PHP (PHPMailer)
composer require phpmailer/phpmailer<?php
use PHPMailer\PHPMailer\Exception;
use PHPMailer\PHPMailer\PHPMailer;
require 'vendor/autoload.php';
$mail = new PHPMailer(true);
try {
$mail->isSMTP();
$mail->Host = 'smtpmq.mailiqo.com';
$mail->Port = 587;
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->SMTPAuth = true;
$mail->Username = getenv('MAILIQO_SMTP_USER');
$mail->Password = getenv('MAILIQO_SMTP_PASS');
$mail->CharSet = PHPMailer::CHARSET_UTF8;
$mail->setFrom('[email protected]', 'Votre boutique');
$mail->addAddress('[email protected]');
$mail->isHTML(true);
$mail->Subject = 'Votre commande a été expédiée';
$mail->Body = '<p>Votre commande est en route.</p>';
$mail->AltBody = 'Votre commande est en route.';
$mail->send();
} catch (Exception $e) {
echo $mail->ErrorInfo;
}Pour le port 465, utilisez $mail->Port = 465 et PHPMailer::ENCRYPTION_SMTPS.
Laravel
Dans .env :
MAIL_MAILER=smtp
MAIL_SCHEME=smtp
MAIL_HOST=smtpmq.mailiqo.com
MAIL_PORT=587
MAIL_USERNAME=votre-identifiant-smtp
MAIL_PASSWORD=votre-mot-de-passe-smtp
MAIL_FROM_ADDRESS[email protected]
MAIL_FROM_NAME="Votre boutique"Avec MAIL_SCHEME=smtp et le port 587, Laravel passe la connexion en STARTTLS. Pour le port 465, utilisez MAIL_PORT=465 et MAIL_SCHEME=smtps. Sous Laravel 10, utilisez MAIL_ENCRYPTION=tls à la place de MAIL_SCHEME.
use Illuminate\Support\Facades\Mail;
Mail::raw('Votre commande est en route.', function ($message) {
$message->to('[email protected]')->subject('Votre commande a été expédiée');
});Dans une vraie application, vous enverriez normalement un Mailable ; la configuration SMTP est la même. Si la configuration est mise en cache, lancez php artisan config:cache après avoir modifié .env.
Symfony Mailer
composer require symfony/mailerDans .env.local :
MAILER_DSN=smtp://USERNAME:[email protected]:587?require_tls=trueSi le nom d'utilisateur ou le mot de passe contiennent des caractères spéciaux, encodez-les en URL. Pour le port 465, utilisez smtps://USERNAME:[email protected]:465.
use Symfony\Component\Mailer\MailerInterface;
use Symfony\Component\Mime\Email;
final class OrderMailer
{
public function __construct(private MailerInterface $mailer)
{
}
public function sendShipped(string $to): void
{
$email = (new Email())
->from('[email protected]')
->to($to)
->subject('Votre commande a été expédiée')
->text('Votre commande est en route.')
->html('<p>Votre commande est en route.</p>');
$this->mailer->send($email);
}
}Si votre application utilise Messenger, Symfony met l'email en file par défaut et le worker l'envoie, les erreurs SMTP apparaissent donc dans le worker.
Python (smtplib)
import os
import smtplib
import ssl
from email.message import EmailMessage
msg = EmailMessage()
msg['From'] = 'Votre boutique <[email protected]>'
msg['To'] = '[email protected]'
msg['Subject'] = 'Votre commande a été expédiée'
msg.set_content('Votre commande est en route.')
msg.add_alternative('<p>Votre commande est en route.</p>', subtype='html')
context = ssl.create_default_context()
with smtplib.SMTP('smtpmq.mailiqo.com', 587, timeout=30) as server:
server.starttls(context=context)
server.login(os.environ['MAILIQO_SMTP_USER'], os.environ['MAILIQO_SMTP_PASS'])
server.send_message(msg)Pour le port 465, utilisez smtplib.SMTP_SSL('smtpmq.mailiqo.com', 465, context=context) et retirez l'appel à starttls().
API
POST https://api.mailiqo.com/v1/mailing/send avec l'email en JSON. Tous les champs sont décrits dans POST /mailing/send.
curl -X POST https://api.mailiqo.com/v1/mailing/send \
-H "X-API-KEY: $MAILIQO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from": "[email protected]",
"to": "[email protected]",
"subject": "Votre commande a été expédiée",
"body_html": "<p>Votre commande est en route.</p>",
"body_txt": "Votre commande est en route."
}'const response = await fetch('https://api.mailiqo.com/v1/mailing/send', {
method: 'POST',
headers: {
'X-API-KEY': process.env.MAILIQO_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
from: '[email protected]',
to: '[email protected]',
subject: 'Votre commande a été expédiée',
body_html: '<p>Votre commande est en route.</p>',
body_txt: 'Votre commande est en route.',
}),
});
const result = await response.json();
console.log(response.status, result.status);<?php
$payload = [
'from' => '[email protected]',
'to' => '[email protected]',
'subject' => 'Votre commande a été expédiée',
'body_html' => '<p>Votre commande est en route.</p>',
'body_txt' => 'Votre commande est en route.',
];
$ch = curl_init('https://api.mailiqo.com/v1/mailing/send');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'X-API-KEY: ' . getenv('MAILIQO_API_KEY'),
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode($payload),
]);
$result = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);// config/services.php: 'mailiqo' => ['key' => env('MAILIQO_API_KEY')],
use Illuminate\Support\Facades\Http;
$response = Http::withHeaders([
'X-API-KEY' => config('services.mailiqo.key'),
])->post('https://api.mailiqo.com/v1/mailing/send', [
'from' => '[email protected]',
'to' => '[email protected]',
'subject' => 'Votre commande a été expédiée',
'body_html' => '<p>Votre commande est en route.</p>',
'body_txt' => 'Votre commande est en route.',
]);
$result = $response->json();use Symfony\Component\DependencyInjection\Attribute\Autowire;
use Symfony\Contracts\HttpClient\HttpClientInterface;
final class MailiqoClient
{
public function __construct(
private HttpClientInterface $httpClient,
#[Autowire(env: 'MAILIQO_API_KEY')] private string $apiKey,
) {
}
public function send(array $email): array
{
$response = $this->httpClient->request('POST', 'https://api.mailiqo.com/v1/mailing/send', [
'headers' => ['X-API-KEY' => $this->apiKey],
'json' => $email,
]);
return $response->toArray(false);
}
}import os
import requests
response = requests.post(
'https://api.mailiqo.com/v1/mailing/send',
headers={'X-API-KEY': os.environ['MAILIQO_API_KEY']},
json={
'from': '[email protected]',
'to': '[email protected]',
'subject': 'Votre commande a été expédiée',
'body_html': '<p>Votre commande est en route.</p>',
'body_txt': 'Votre commande est en route.',
},
timeout=30,
)
result = response.json()Un 200 signifie que l'email a été mis en file : vérifiez status et, s'il vaut warning, la liste rejected_recipients. Voir API d'envoi d'emails.
Erreurs et limites d'envoi
API
| HTTP | Que faire |
|---|---|
200 | Mis en file. Avec status = warning, certains destinataires ont été rejetés : vérifiez rejected_recipients. |
400 | Corrigez la requête : error.code en donne la raison. Voir Erreurs. |
401 | Vérifiez la clé API. |
429 | Limite d'envoi atteinte (code 1421). Attendez le nombre de secondes indiqué dans l'en-tête Retry-After et renvoyez. |
500 | Réessayez plus tard. |
Une requête rejetée avec 429 n'est pas mise en file : votre application doit la renvoyer une fois le délai Retry-After écoulé. Voir Limites d'envoi.
SMTP
Les réponses commençant par 4 sont temporaires, comme 451 4.7.1 quand la limite d'envoi est atteinte : le serveur n'a pas accepté le message, renvoyez-le donc plus tard. Les réponses commençant par 5 sont permanentes : renvoyer le même message échoue tant que vous ne corrigez pas la cause. Voir Erreurs SMTP.
Où chaque bibliothèque vous donne la réponse du serveur :
| Bibliothèque | Où |
|---|---|
| Nodemailer | err.responseCode et err.response |
| PHPMailer | $mail->ErrorInfo |
| Laravel et Symfony Mailer | Le message de la TransportException |
| Python | smtp_code et smtp_error de smtplib.SMTPResponseException et ses sous-classes |
Sources
Vérifiées le 2 novembre 2026 :
- Nodemailer — SMTP transport — documentation Nodemailer
- PHPMailer — dépôt officiel
- Laravel — Mail — documentation Laravel
- Symfony — Sending emails with Mailer — documentation Symfony
- smtplib — documentation Python
Étapes suivantes
- API d'envoi d'emails → /fr/api-reference/sending
- Erreurs SMTP → /fr/smtp/errors
