Was ist die Mailtre API?

Die Mailtre API ist eine RESTful-Schnittstelle, die es Ihnen ermöglicht, alle Funktionen von Mailtre programmatisch zu nutzen. Anstatt Aktionen manuell im Dashboard auszuführen, können Sie diese automatisiert per Code durchführen - perfekt für Integrationen mit anderen Systemen, Automatisierungen und individuelle Workflows.

API Endpoint

Alle API-Anfragen werden an folgenden Endpoint gesendet:
https://mail.mailtre.com/api/v1/

Benutzerverwaltung

Erstellen, bearbeiten und verwalten Sie Kunden automatisch über die API

Listen & Abonnenten

Verwalten Sie Mailinglisten und fügen Sie Abonnenten dynamisch hinzu

Kampagnen

Starten, stoppen und analysieren Sie Kampagnen programmatisch

Automatisierung

Erstellen und steuern Sie Marketing Automation Workflows

Analytics

Rufen Sie Statistiken und Performance-Daten ab

Integrationen

Verbinden Sie Mailtre mit Ihren bestehenden Tools und Systemen

Authentifizierung

Jede API-Anfrage muss mit einem gültigen API Token authentifiziert werden. Dieser Token beweist, dass Sie berechtigt sind, Aktionen in Ihrem Mailtre-Account auszuführen.

API Token erhalten

Sie finden Ihren persönlichen API Token in Ihrem Mailtre Dashboard unter:
Einstellungen → API → API Token

Token in Anfragen verwenden

Fügen Sie den API Token als URL-Parameter zu jeder Anfrage hinzu:

HTTP

https://mail.mailtre.com/api/v1/lists?api_token=YOUR_API_TOKEN

Sicherheitshinweis

Geben Sie Ihren API Token niemals öffentlich weiter!
Jeder, der Zugriff auf Ihren Token hat, kann:

Auf Ihre Kunden und Kampagnen zugreifen
E-Mails über Ihr System versenden
Daten manipulieren oder löschen

Wenn Sie vermuten, dass Ihr Token kompromittiert wurde, generieren Sie sofort einen neuen Token im Dashboard. Der alte Token wird dann ungültig.

API Endpunkte

Kunden verwalten

Erstellen Sie neue Kunden automatisch, z.B. wenn sich jemand auf Ihrer Website registriert.

POST /api/v1/customers

Parameter	Typ	Beschreibung
api_token	string	Ihr API Authentifizierungs-Token (erforderlich)
email	string	E-Mail-Adresse des Kunden (erforderlich)
first_name	string	Vorname des Kunden (optional)
last_name	string	Nachname des Kunden (optional)

cURL

curl -X POST \
  'https://mail.mailtre.com/api/v1/customers?api_token=YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "kunde@example.com",
    "first_name": "Max",
    "last_name": "Mustermann"
  }'

Listen verwalten

Erstellen Sie neue Mailinglisten für verschiedene Zielgruppen.

POST /api/v1/lists

GET /api/v1/lists

PHP

// Neue Liste erstellen
$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://mail.mailtre.com/api/v1/lists?api_token=YOUR_API_TOKEN",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => json_encode([
    "name" => "Newsletter Abonnenten",
    "description" => "Hauptliste für Newsletter"
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

Abonnenten hinzufügen

Fügen Sie neue Abonnenten zu einer bestehenden Liste hinzu.

POST /api/v1/subscribers

JavaScript

// Abonnent hinzufügen
const response = await fetch(
  'https://mail.mailtre.com/api/v1/subscribers?api_token=YOUR_API_TOKEN',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      email: 'neuer@abonnent.com',
      list_id: '123',
      first_name: 'Anna',
      last_name: 'Schmidt'
    })
  }
);

const data = await response.json();
console.log(data);

Kampagnen starten

Starten Sie E-Mail-Kampagnen automatisch über die API.

POST /api/v1/campaigns/send

GET /api/v1/campaigns/{id}/stats

Statistiken abrufen

Rufen Sie Performance-Daten Ihrer Kampagnen ab - Öffnungsraten, Klickraten und mehr.

Python

import requests

# Kampagnen-Statistiken abrufen
api_token = "YOUR_API_TOKEN"
campaign_id = "123"

url = f"https://mail.mailtre.com/api/v1/campaigns/{campaign_id}/stats?api_token={api_token}"
response = requests.get(url)

if response.status_code == 200:
    stats = response.json()
    print(f"Öffnungsrate: {stats['open_rate']}%")
    print(f"Klickrate: {stats['click_rate']}%")

Praktische Anwendungsfälle

1. WordPress Integration

Fügen Sie automatisch neue Blog-Abonnenten zu Ihrer Mailtre-Liste hinzu, wenn sich jemand auf Ihrer WordPress-Website registriert.

2. E-Commerce Integration

Verbinden Sie Ihren Online-Shop mit Mailtre:

Automatische Bestellbestätigungen versenden
Abandoned Cart E-Mails bei abgebrochenen Käufen
Kunden nach Kategorie-Interesse segmentieren
Produktempfehlungen basierend auf Kaufhistorie

3. CRM-System Integration

Synchronisieren Sie Kontakte zwischen Ihrem CRM und Mailtre. Wenn ein neuer Lead im CRM erstellt wird, wird er automatisch zur entsprechenden E-Mail-Liste hinzugefügt.

4. Formular-Integration

Verbinden Sie beliebige Formulare auf Ihrer Website (Kontaktformulare, Landing Pages, etc.) direkt mit Mailtre und fügen Sie Leads automatisch zu Ihren Listen hinzu.

5. Event-basierte Automatisierung

Triggern Sie E-Mail-Sequenzen basierend auf Benutzer-Aktionen:

Willkommens-Serie nach Registrierung
Geburtstags-E-Mails
Re-Engagement bei Inaktivität
Webinar-Reminder und Follow-ups

Rate Limits

Um die Stabilität und Performance für alle Nutzer zu gewährleisten, gelten folgende Limits:

API Limits

1.000 Anfragen pro Stunde pro API Token
10.000 Anfragen pro Tag pro API Token
Bei Überschreitung erhalten Sie HTTP Status Code 429 (Too Many Requests)

Fehlerbehandlung

Die API verwendet Standard-HTTP-Statuscodes zur Fehlerbehandlung:

Status Code	Bedeutung	Beschreibung
200	OK	Anfrage erfolgreich
201	Created	Ressource erfolgreich erstellt
400	Bad Request	Ungültige Anfrage oder fehlende Parameter
401	Unauthorized	Ungültiger oder fehlender API Token
404	Not Found	Ressource nicht gefunden
429	Too Many Requests	Rate Limit überschritten
500	Internal Server Error	Serverfehler - kontaktieren Sie den Support

Support & Ressourcen

Benötigen Sie Hilfe bei der API-Integration? Wir sind für Sie da!

Dokumentation

Ausführliche API-Dokumentation mit allen Endpunkten und Parametern

Code-Beispiele

Beispiele in PHP, Python, JavaScript, Ruby und mehr

Developer Support

Unser Entwickler-Team hilft bei technischen Fragen

Mailtre API Dokumentation

Was ist die Mailtre API?

API Endpoint

Benutzerverwaltung

Listen & Abonnenten

Kampagnen

Automatisierung

Analytics

Integrationen

Authentifizierung

API Token erhalten

Token in Anfragen verwenden

Sicherheitshinweis

API Endpunkte

Kunden verwalten

Listen verwalten

Abonnenten hinzufügen

Kampagnen starten

Statistiken abrufen

Praktische Anwendungsfälle

1. WordPress Integration

2. E-Commerce Integration

3. CRM-System Integration

4. Formular-Integration

5. Event-basierte Automatisierung

Rate Limits

API Limits

Fehlerbehandlung

Support & Ressourcen

Dokumentation

Code-Beispiele

Developer Support

Bereit für die Integration?

Wir verwenden Cookies

Cookie Einstellungen

Notwendige Cookies

Analyse Cookies

Marketing Cookies

Externe Medien

Mailtre API Dokumentation

Was ist die Mailtre API?

API Endpoint

Benutzerverwaltung

Listen & Abonnenten

Kampagnen

Automatisierung

Analytics

Integrationen

Authentifizierung

API Token erhalten

Token in Anfragen verwenden

Sicherheitshinweis

API Endpunkte

Kunden verwalten

Listen verwalten

Abonnenten hinzufügen

Kampagnen starten

Statistiken abrufen

Praktische Anwendungsfälle

1. WordPress Integration

2. E-Commerce Integration

3. CRM-System Integration

4. Formular-Integration

5. Event-basierte Automatisierung

Rate Limits

API Limits

Fehlerbehandlung

Support & Ressourcen

Dokumentation

Code-Beispiele

Developer Support

Bereit für die Integration?