API — häufig gestellte Fragen
Schnelle Antworten für Entwickler, die Mailpro integrieren.
Wie erhalte ich einen API-Key?+
Melden Sie sich in Ihrem Mailpro-Konto an und öffnen Sie Einstellungen → API-Zugang. Dort finden Sie Ihre numerische Client-ID und Ihren API-Key (GUID). Sie können die APIs direkt damit aufrufen oder sie am Token-Endpoint gegen ein OAuth 2.0 / Bearer JWT-Token eintauschen.
Welche Authentifizierungsmethoden werden unterstützt?+
Drei: OAuth 2.0 mit PKCE (empfohlen für Drittanbieter-Apps und Plattformen wie Zapier, Make und n8n), Bearer JWT (Legacy) und id_client + API-Key. Ein einziges OAuth-Token funktioniert über die Email-, CRM- und SMS-API hinweg.
Sind die APIs REST oder SOAP?+
Es sind moderne REST-APIs über HTTPS. Die Antworten erfolgen standardmäßig in JSON (die Email- und SMS-API unterstützen auch XML), mit vorhersehbaren Ressourcen sowie Standard-HTTP-Verben und -Statuscodes.
Gibt es eine interaktive Dokumentation oder einen Testmodus?+
Ja. Jeder Endpoint kann live aus der interaktiven Swagger-Dokumentation getestet werden, und Sie können Test-E-Mails und -SMS an Ihre eigene Adresse senden, bevor Sie in Produktion gehen.
Welche Sprachen und SDKs kann ich verwenden?+
Jede Sprache, die HTTP und JSON spricht. Wir veröffentlichen ein offizielles SDK auf GitHub und stellen sofort einsatzbereite Beispiele in curl, Node.js, Python, PHP und C# bereit.
Unterstützen die APIs Webhooks?+
Ja. Abonnieren Sie Echtzeit-Events — E-Mail zugestellt, geöffnet, geklickt, zurückgewiesen sowie SMS-Zustellberichte — ausgeliefert als HMAC-SHA256-signierte HTTP-Callbacks.
Kann ich transaktionale E-Mails senden, nicht nur Kampagnen?+
Ja. Senden Sie eine einzelne E-Mail an einen Empfänger mit benutzerdefinierten Feldern, Anhängen und optionaler Planung — über die Email API oder die CRM API.
Kann ich Dateianhänge senden? Was sind die Grenzen und Kosten?+
Ja — hängen Sie Dateien an, wenn Sie eine E-Mail über die Email API (v2) oder CRM API (v3) senden: bis zu 5 Dateien, 10 MB pro Datei und 15 MB insgesamt. Senden Sie sie als Base64-kodierte Anhänge über beide APIs (die Email API akzeptiert auch multipart/form-data-Datei-Uploads). Die Kosten betragen 1 Credit pro 500 KB Anhänge, wobei die ersten 500 KB im Basis-Credit der E-Mail enthalten sind (Anhänge bis ~500 KB kosten also nichts extra). Gängige Dokument- und Bildformate werden akzeptiert; ausführbare Dateien und Skriptdateien (.exe, .bat, .js, .vbs, .msi, .jar, .dll usw.) werden aus Sicherheitsgründen blockiert.
Wie funktioniert die SMS-Abrechnung?+
SMS ist Credit-basiert. Eine SMS kostet den Credit-Preis des Ziellandes multipliziert mit der Anzahl der Teile (eine lange Nachricht wird in mehrere Teile aufgeteilt). Der E-Mail-Versand nutzt E-Mail-Credits.
Welche E-Mail-Adressformate werden akzeptiert?+
Jede RFC-konforme Adresse, einschließlich Sub-Adressierung mit einem „+" (zum Beispiel [email protected]), die von Gmail, Fastmail, Proton und anderen unterstützt wird.
Wie hoch sind die Rate-Limits?+
Anfragen sind pro Konto ratenbegrenzt. Wenn Sie das Limit überschreiten, erhalten Sie eine HTTP-429-Antwort mit klaren Headern, sodass Sie zurückstufen und ordnungsgemäß erneut versuchen können.