Codebeispiele
Beispiele für den Versand über Mailiqo aus den gängigsten Sprachen und Frameworks, per SMTP oder über die API.
Versionen geprüft am 2. November 2026
Nodemailer 10.3.1, PHPMailer 7.1.1, Laravel 13 (gilt auch für 11 und 12), Symfony 8.1 und die Python-3-Standardbibliothek. Basierend auf der offiziellen Dokumentation jedes Projekts (Links am Ende).
Bevor du anfängst
- SMTP: Host
smtpmq.mailiqo.com, Port587mit STARTTLS (oder465mit implizitem TLS) sowie SMTP-Benutzername und -Passwort der Domain aus E-Mail → Domains. - API: ein API-Key aus Einstellungen → API & Integrationen, gesendet im Header
X-API-KEY. Siehe Authentifizierung. - Der Absender muss eine Adresse auf der verifizierten Domain sein.
- Halte Zugangsdaten aus dem Code heraus. Die Beispiele lesen sie aus den Umgebungsvariablen
MAILIQO_SMTP_USER,MAILIQO_SMTP_PASSundMAILIQO_API_KEY.
SMTP ist der schnellste Weg, eine Anwendung anzubinden, die bereits E-Mails sendet. Die API liefert das Ergebnis pro Empfänger und eine uuid, um die Zustellung zu verfolgen. Siehe SMTP-Überblick und E-Mail-Versand-API.
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: '"Dein Shop" <[email protected]>',
to: '[email protected]',
subject: 'Deine Bestellung wurde versandt',
text: 'Deine Bestellung ist unterwegs.',
html: '<p>Deine Bestellung ist unterwegs.</p>',
});
console.log(info.messageId);secure: false mit requireTLS: true lässt Nodemailer die Verbindung per STARTTLS aufwerten und fehlschlagen, wenn das nicht geht. Für Port 465 verwende port: 465 und 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]', 'Dein Shop');
$mail->addAddress('[email protected]');
$mail->isHTML(true);
$mail->Subject = 'Deine Bestellung wurde versandt';
$mail->Body = '<p>Deine Bestellung ist unterwegs.</p>';
$mail->AltBody = 'Deine Bestellung ist unterwegs.';
$mail->send();
} catch (Exception $e) {
echo $mail->ErrorInfo;
}Für Port 465 verwende $mail->Port = 465 und PHPMailer::ENCRYPTION_SMTPS.
Laravel
In .env:
MAIL_MAILER=smtp
MAIL_SCHEME=smtp
MAIL_HOST=smtpmq.mailiqo.com
MAIL_PORT=587
MAIL_USERNAME=your-smtp-username
MAIL_PASSWORD=your-smtp-password
MAIL_FROM_ADDRESS[email protected]
MAIL_FROM_NAME="Dein Shop"Mit MAIL_SCHEME=smtp und Port 587 wertet Laravel die Verbindung per STARTTLS auf. Für Port 465 verwende MAIL_PORT=465 und MAIL_SCHEME=smtps. Unter Laravel 10 verwende MAIL_ENCRYPTION=tls statt MAIL_SCHEME.
use Illuminate\Support\Facades\Mail;
Mail::raw('Deine Bestellung ist unterwegs.', function ($message) {
$message->to('[email protected]')->subject('Deine Bestellung wurde versandt');
});In einer echten Anwendung sendest du normalerweise ein Mailable; die SMTP-Konfiguration ist dieselbe. Ist die Konfiguration gecacht, führe nach Änderungen an .env php artisan config:cache aus.
Symfony Mailer
composer require symfony/mailerIn .env.local:
MAILER_DSN=smtp://USERNAME:[email protected]:587?require_tls=trueEnthalten Benutzername oder Passwort Sonderzeichen, URL-kodiere sie. Für Port 465 verwende 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('Deine Bestellung wurde versandt')
->text('Deine Bestellung ist unterwegs.')
->html('<p>Deine Bestellung ist unterwegs.</p>');
$this->mailer->send($email);
}
}Verwendet deine Anwendung Messenger, reiht Symfony die E-Mail standardmäßig ein und der Worker sendet sie, SMTP-Fehler tauchen also im Worker auf.
Python (smtplib)
import os
import smtplib
import ssl
from email.message import EmailMessage
msg = EmailMessage()
msg['From'] = 'Dein Shop <[email protected]>'
msg['To'] = '[email protected]'
msg['Subject'] = 'Deine Bestellung wurde versandt'
msg.set_content('Deine Bestellung ist unterwegs.')
msg.add_alternative('<p>Deine Bestellung ist unterwegs.</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)Für Port 465 verwende smtplib.SMTP_SSL('smtpmq.mailiqo.com', 465, context=context) und entferne den Aufruf von starttls().
API
POST https://api.mailiqo.com/v1/mailing/send mit der E-Mail als JSON. Alle Felder sind beschrieben unter 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": "Deine Bestellung wurde versandt",
"body_html": "<p>Deine Bestellung ist unterwegs.</p>",
"body_txt": "Deine Bestellung ist unterwegs."
}'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: 'Deine Bestellung wurde versandt',
body_html: '<p>Deine Bestellung ist unterwegs.</p>',
body_txt: 'Deine Bestellung ist unterwegs.',
}),
});
const result = await response.json();
console.log(response.status, result.status);<?php
$payload = [
'from' => '[email protected]',
'to' => '[email protected]',
'subject' => 'Deine Bestellung wurde versandt',
'body_html' => '<p>Deine Bestellung ist unterwegs.</p>',
'body_txt' => 'Deine Bestellung ist unterwegs.',
];
$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' => 'Deine Bestellung wurde versandt',
'body_html' => '<p>Deine Bestellung ist unterwegs.</p>',
'body_txt' => 'Deine Bestellung ist unterwegs.',
]);
$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': 'Deine Bestellung wurde versandt',
'body_html': '<p>Deine Bestellung ist unterwegs.</p>',
'body_txt': 'Deine Bestellung ist unterwegs.',
},
timeout=30,
)
result = response.json()Ein 200 bedeutet, dass die E-Mail eingereiht wurde: prüfe status und, wenn er warning ist, die Liste rejected_recipients. Siehe E-Mail-Versand-API.
Fehler und Sendelimits
API
| HTTP | Was zu tun ist |
|---|---|
200 | Eingereiht. Bei status = warning wurden einige Empfänger abgelehnt: prüfe rejected_recipients. |
400 | Korrigiere die Anfrage: error.code nennt den Grund. Siehe Fehler. |
401 | Prüfe den API-Key. |
429 | Sendelimit erreicht (Code 1421). Warte die Sekunden aus dem Retry-After-Header und sende erneut. |
500 | Versuche es später erneut. |
Eine mit 429 abgelehnte Anfrage wird nicht eingereiht: deine Anwendung muss sie nach Ablauf der Retry-After-Zeit erneut senden. Siehe Sendelimits.
SMTP
Antworten, die mit 4 beginnen, sind temporär, etwa 451 4.7.1, wenn das Sendelimit erreicht ist: der Server hat die Nachricht nicht angenommen, sende sie also später erneut. Antworten, die mit 5 beginnen, sind permanent: dieselbe Nachricht erneut zu senden schlägt fehl, bis du die Ursache behebst. Siehe SMTP-Fehler.
Wo dir jede Bibliothek die Antwort des Servers liefert:
| Bibliothek | Wo |
|---|---|
| Nodemailer | err.responseCode und err.response |
| PHPMailer | $mail->ErrorInfo |
| Laravel und Symfony Mailer | Die Meldung der TransportException |
| Python | smtp_code und smtp_error von smtplib.SMTPResponseException und ihren Unterklassen |
Quellen
Geprüft am 2. November 2026:
- Nodemailer — SMTP transport — Nodemailer-Dokumentation
- PHPMailer — offizielles Repository
- Laravel — Mail — Laravel-Dokumentation
- Symfony — Sending emails with Mailer — Symfony-Dokumentation
- smtplib — Python-Dokumentation
Nächste Schritte
- E-Mail-Versand-API → /de/api-reference/sending
- SMTP-Fehler → /de/smtp/errors
