Skip to content

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, Port 587 mit STARTTLS (oder 465 mit 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_PASS und MAILIQO_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) ​

bash
npm install nodemailer
js
import 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) ​

bash
composer require phpmailer/phpmailer
php
<?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:

ini
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.

php
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 ​

bash
composer require symfony/mailer

In .env.local:

ini
MAILER_DSN=smtp://USERNAME:[email protected]:587?require_tls=true

Enthalten Benutzername oder Passwort Sonderzeichen, URL-kodiere sie. Für Port 465 verwende smtps://USERNAME:[email protected]:465.

php
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) ​

python
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.

bash
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."
  }'
js
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
<?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);
php
// 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();
php
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);
    }
}
python
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 ​

HTTPWas zu tun ist
200Eingereiht. Bei status = warning wurden einige Empfänger abgelehnt: prüfe rejected_recipients.
400Korrigiere die Anfrage: error.code nennt den Grund. Siehe Fehler.
401Prüfe den API-Key.
429Sendelimit erreicht (Code 1421). Warte die Sekunden aus dem Retry-After-Header und sende erneut.
500Versuche 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:

BibliothekWo
Nodemailererr.responseCode und err.response
PHPMailer$mail->ErrorInfo
Laravel und Symfony MailerDie Meldung der TransportException
Pythonsmtp_code und smtp_error von smtplib.SMTPResponseException und ihren Unterklassen

Quellen ​

Geprüft am 2. November 2026:


Nächste Schritte ​

Built with VitePress