Zum Hauptinhalt springen
CaptainDNS

Postmark (ActiveCampaign): Technischer Leitfaden für transaktionale E-Mails

Von CaptainDNS
Veröffentlicht am 28. Januar 2026

Postmark Dashboard mit Message Streams und DNS-DKIM-Konfiguration
TL;DR
  • Postmark, spezialisiert auf transaktionale E-Mails, wurde 2022 von ActiveCampaign übernommen und setzt auf herausragende Zustellbarkeit mit strikter Trennung von transaktionalen/Broadcast-E-Mails über Message Streams.
  • Einfache REST-API unter api.postmarkapp.com mit Header X-Postmark-Server-Token, maximal 50 Empfänger pro E-Mail, 500 Nachrichten pro Batch.
  • DKIM 1024 Bit mit Zeitstempel-Selektor ([timestamp]pm._domainkey), vierteljährliche manuelle Rotation empfohlen.
  • Custom Return-Path über CNAME pm-bounces.captaindns.com → pm.mtasv.net für SPF-DMARC-Alignment ausschließlich im Relaxed-Modus (kein Strict möglich).
  • Dedizierte IP für 50$/Monat ab 300K E-Mails/Monat, automatisches Warm-up über 3-6 Wochen.
  • Pläne ab 15$/Monat für 10K E-Mails (Basic), Free Developer Plan auf 100 E-Mails/Monat begrenzt.

Einführung

Postmark hat sich einen hervorragenden Ruf im Bereich transaktionaler E-Mails erarbeitet, mit einer klaren Philosophie: Zustellbarkeit an erster Stelle. Im Mai 2022 von ActiveCampaign übernommen, bleibt der Dienst ein eigenständiges Produkt mit eigenem Team und technischer DNA. Die Plattform verarbeitet Milliarden von E-Mails mit ausschließlichem Fokus auf transaktionale Nachrichten (Bestellbestätigungen, Passwort-Zurücksetzungen, Benachrichtigungen).

Die Besonderheit von Postmark liegt in der strikten Trennung zwischen transaktionalen und Broadcast-E-Mails über Message Streams. Diese Architektur garantiert, dass Ihre kritischen E-Mails niemals von Marketing-Kampagnen beeinträchtigt werden. Der gemeinsam genutzte IP-Pool wird aktiv überwacht, um eine einwandfreie Reputation zu gewährleisten.

Dieser Leitfaden richtet sich an Entwickler, DevOps-Ingenieure und Systemarchitekten, die Postmark mit einem vollständigen Verständnis der Infrastruktur integrieren möchten: DNS-Konfiguration, Entscheidung zwischen API und SMTP, IP-Verwaltung, Webhooks und technische Limits.

REST-API vs. SMTP-Relay: Architektur und Integrationsentscheidung

Postmark bietet zwei Integrationsmethoden an, die jeweils für spezifische Anwendungsfälle geeignet sind.

Vergleich zwischen REST-API und SMTP-Relay bei Postmark

Technischer Vergleich

KriteriumREST-APISMTP-Relay
EndpointPOST https://api.postmarkapp.com/emailsmtp.postmarkapp.com Ports 587/2525
AuthentifizierungHeader X-Postmark-Server-TokenUsername: API-Key / Passwort: API-Key
Empfanger/E-Mailmax. 50 (To + Cc + Bcc)max. 50
Batch500 Nachrichten/Aufruf, max. 50 MB1 E-Mail pro Verbindung
Max. Grosse10 MB pro E-Mail10 MB pro E-Mail
TemplatesMustachio (Handlebars-ähnlich)Nur Inline-Inhalt
SchedulingNativ nicht unterstütztNativ nicht unterstützt
TrackingÜber JSON-ParameterÜber X-PM-*-Header
Idealer AnwendungsfallModerne Apps, Batch, TemplatesLegacy, CMS, bestehende Mailserver

Wann sollten Sie die REST-API wählen?

Die REST-API ist die empfohlene Methode für jede neue Integration. Sie bietet präzise Kontrolle über jeden Aspekt des Versands.

Haupt-Endpoint: POST https://api.postmarkapp.com/email

Erforderliche Header:

Content-Type: application/json
Accept: application/json
X-Postmark-Server-Token: ihr-server-token

Vollständiges Versandbeispiel:

curl "https://api.postmarkapp.com/email" \
  -X POST \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-Postmark-Server-Token: ihr-server-token" \
  -d '{
    "From": "notifications@captaindns.com",
    "To": "kunde@captaindns.com",
    "Subject": "Ihre DNS-Analyse ist fertig",
    "TextBody": "Guten Tag, Ihr DNS-Bericht ist verfugbar.",
    "HtmlBody": "<html><body><strong>Guten Tag</strong>, Ihr DNS-Bericht ist verfugbar.</body></html>",
    "Tag": "dns-report",
    "TrackOpens": true,
    "TrackLinks": "HtmlAndText",
    "MessageStream": "outbound",
    "Metadata": {
      "report_id": "RPT-12345",
      "user_id": "USR-789"
    }
  }'

Erwartete Antwort (200 OK):

{
  "To": "kunde@captaindns.com",
  "SubmittedAt": "2026-01-28T10:30:00.1234567-05:00",
  "MessageID": "b7bc2f4a-e38e-4336-af7d-e6c392c2f817",
  "ErrorCode": 0,
  "Message": "OK"
}

Wichtige Limits:

  • Rate Limit: nicht explizit veröffentlicht, internes Monitoring
  • Empfänger: max. 50 pro E-Mail (To + Cc + Bcc)
  • Batch: 500 Nachrichten pro Aufruf, 50 MB gesamt
  • E-Mail-Grosse: max. 10 MB

Offizielle SDKs: Ruby, .NET, Java, PHP, Node.js. Kein offizielles Python-SDK (verwenden Sie postmarker oder python-postmark).

Wann sollten Sie SMTP-Relay wählen?

SMTP-Relay ist ideal für Legacy-Systeme oder Anwendungen, die nur SMTP unterstützen.

Offizielle Konfiguration:

# Transaktional
SMTP server: smtp.postmarkapp.com
Port: 587 (empfohlen) oder 2525 (Fallback)

# Broadcast
SMTP server: smtp-broadcasts.postmarkapp.com
Port: 587 oder 2525

# Authentifizierung
Username: ihr-server-api-token
Password: ihr-server-api-token

Verfügbare Ports:

PortSupportHinweise
25JaSMTP-Standard
465NeinImplicit TLS nicht unterstützt
587JaEmpfohlen - Submission-Port
2525JaAlternativer Port

Authentifizierungsmethoden: CRAM-MD5 (empfohlen), DIGEST-MD5, PLAIN, LOGIN.

Proprietäre X-PM-*-Header:

HeaderVerwendungBeispiel
X-PM-TagKategorisierungX-PM-Tag: password-reset
X-PM-Message-StreamStream angebenX-PM-Message-Stream: outbound
X-PM-Metadata-*Benutzerdefinierte MetadatenX-PM-Metadata-user-id: 12345
X-PM-TrackOpensÖffnungs-TrackingX-PM-TrackOpens: true
X-PM-TrackLinksLink-TrackingX-PM-TrackLinks: HtmlAndText

Domain-Authentifizierung: DKIM, Return-Path und DMARC-Alignment

Die Domain-Authentifizierung bei Postmark basiert auf DKIM und einem anpassbaren Return-Path. Die Konfiguration erfolgt unter Sender Signatures oder Domain Authentication.

DNS-Authentifizierungsablauf mit Postmark

DKIM-Konfiguration

Postmark generiert einen 1024-Bit-DKIM-Schlüssel mit einem eindeutigen Zeitstempel-basierten Selektor.

Selektor-Format: [timestamp]pm._domainkey.captaindns.com

Beispiele für Selektoren:

  • 20260128pm._domainkey.captaindns.com
  • jan2026pm._domainkey.captaindns.com

Zu erstellender DNS-Eintrag:

Type: TXT
Hostname: 20260128pm._domainkey.captaindns.com
Value: k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDO...

Eigenschaften:

  • Schlüsselgröße: 1024 Bit (nicht 2048)
  • Rotation: manuell, vierteljährlich empfohlen
  • Rotations-API: POST /domains/{domainid}/rotatedkim

Die Rotation verwendet das Zwei-Selektor-System: Postmark bereitet den neuen Selektor vor, bevor umgeschaltet wird, was einen unterbrechungsfreien Übergang gewährleistet.

SPF: erforderlich oder nicht?

SPF ist für Postmark nicht mehr erforderlich. Hier ist der Grund:

Standardmäßig verwendet Postmark seine eigene Domain für den Return-Path:

Return-Path: <pm_bounces@pm.mtasv.net>

Die Empfangsserver prüfen SPF gegen die Return-Path-Domain (pm.mtasv.net), nicht gegen Ihre From-Domain (captaindns.com). Ihre E-Mails bestehen SPF automatisch ohne DNS-Änderungen auf Ihrer Seite.

Optionaler Include (wenn Sie explizit sein möchten):

v=spf1 a mx include:spf.mtasv.net ~all

Custom Return-Path und DMARC-Alignment

Um SPF-DMARC-Alignment zu erreichen, müssen Sie einen benutzerdefinierten Return-Path konfigurieren.

Erforderlicher DNS-Eintrag:

Type: CNAME
Hostname: pm-bounces.captaindns.com
Value: pm.mtasv.net

Nach der Konfiguration:

Return-Path: <pm_bounces@pm-bounces.captaindns.com>

Auswirkung auf DMARC-Alignment:

KonfigurationSPF PassDMARC-Alignment
Standard-Return-PathJa (Postmark-Domain)Nein - schlägt fehl
Custom Return-PathJa (Kunden-Subdomain)Ja - nur Relaxed

Kritischer Punkt: Strict Alignment (aspf=s) ist mit Postmark nicht möglich, da der Return-Path immer eine Subdomain verwendet (pm-bounces.captaindns.com ≠ captaindns.com).

Empfohlene Strategie: Verlassen Sie sich auf DKIM für DMARC-Alignment, das den Strict-Modus (adkim=s) unterstützt.

Vollständige DNS-Übersichtstabelle

EintragTypHostnameWertErforderlich
DKIMTXT[timestamp]pm._domainkey.captaindns.comk=rsa; p=[offentlicher-schlussel]Ja - empfohlen
Return-PathCNAMEpm-bounces.captaindns.compm.mtasv.netFür DMARC-Alignment
Link-TrackingCNAME[custom].captaindns.com[postmark-wert]Optional
SPFTXTcaptaindns.comv=spf1 include:spf.mtasv.net ~allNein - nicht erforderlich

Message Streams: Transaktional vs. Broadcast

Postmark erzwingt eine strikte Trennung zwischen transaktionalen und Broadcast-E-Mails über Message Streams. Diese Architektur schützt die Reputation Ihrer kritischen E-Mails.

Stream-Architektur

AspektTransaktionalBroadcast
VerwendungDurch Benutzeraktionen ausgeloste E-MailsMassen-E-Mails (Newsletter)
SMTP-Hostsmtp.postmarkapp.comsmtp-broadcasts.postmarkapp.com
AbmeldelinkOptionalErforderlich
InfrastrukturDedizierter IP-PoolSeparater IP-Pool
Standard-Streamoutboundbroadcast

Für Broadcast-Streams ist der Abmeldelink obligatorisch:

<a href="{{{ pm:unsubscribe }}}">Abmelden</a>

Verwaltung der Abmeldungen:

  • UnsubscribeHandlingType: "Postmark": automatisch verwaltet
  • UnsubscribeHandlingType: "None": manuell zu verwalten

Limits der Message Streams

RessourceLimit
Streams pro Servermax. 10 (Support für mehr kontaktieren)
Inbound-Streams pro Servernur 1
Stream-Namemax. 100 Zeichen
Archivierte StreamsLöschung nach 45 Tagen

Shared IP vs. Dedizierte IP

Shared IP-Pool (alle Pläne)

Standardmäßig nutzen alle Postmark-Kunden einen hochreputierten Shared IP-Pool.

Postmark-Philosophie: "Ein hochwertiger, hochreputierter IP-Pool bietet für die Mehrheit der Versender eine bessere und zuverlässigere Zustellbarkeit".

Eigenschaften:

  • Aktiv überwachter Pool
  • Automatische Blacklist-Warnungen
  • Kein Warm-up erforderlich
  • Geeignet für die meisten Volumen

Dedizierte IP

Für hohe Volumen bietet Postmark dedizierte IPs an.

KriteriumWert
Mindestvolumen300.000 E-Mails/Monat
Kosten50$/IP/Monat (keine Einrichtungsgebuhr)
Zusätzliche IP100.000+ Nachrichten/Tag erforderlich
Warm-upAutomatisch, 3-6 Wochen
OverflowWährend des Warm-ups über Shared Pool geroutet

Automatisches Warm-up:

  • Von Postmark festgelegte tägliche Limits
  • Anpassung basierend auf der Reaktion der Empfänger
  • Uberschussiges Volumen wird über den Shared Pool gesendet
  • Kontinuierliches Monitoring durch das Postmark-Team

Re-Warmup erforderlich: wenn das Volumen 4 Wochen in Folge unter 20.000 Nachrichten/Woche fällt.

Reverse DNS: von Postmark verwaltet (nicht vom Kunden anpassbar).

Preise 2026

Pläne und Preise

PlanPreis/Monat (10K)Overage /1000ServerDomainsStreamsDedizierte IP
Free Developer0$N/A101030Nein
Basic15$1,80$5515Nein
Pro16,50$1,30$101030Ja (ab 300K)
Platform18$1,20$unbegr.unbegr.unbegr.Ja (ab 300K)

Limits des Free Developer Plans:

  • 100 E-Mails/Monat (festes Limit)
  • Kein Overage möglich
  • Ideal für Tests und Entwicklung

Skalierung nach Volumen

Monatliches VolumenUngefahrer Preis
10.00015-18$/Monat
50.00050-60$/Monat
125.000ca. 100$/Monat
300.000ca. 200$/Monat
700.000ca. 400$/Monat
5.000.000+Individuelle Preise

Optionale Add-ons

Add-onPreis
Dedizierte IP50$/Monat/IP
Custom Activity Retentionab 5$/Monat
DMARC Digestsab 14$/Monat/Domain

Zahlungsregeln

  • Jede gesendete Nachricht = 1 E-Mail
  • Jede Cc/Bcc-Adresse = 1 zusätzliche E-Mail
  • Sandbox-Nachrichten = werden gezählt
  • Nicht genutzte E-Mails = werden nicht übertragen

Webhooks und Events

Postmark bietet ein umfassendes Webhook-System zur Verfolgung des Lebenszyklus Ihrer E-Mails.

Postmark Webhook-Architektur

Verfügbare Events

EventBeschreibung
DeliveryE-Mail an Empfangsserver zugestellt
BounceE-Mail zurückgewiesen (Hard, Soft, Transient)
OpenEmpfänger hat E-Mail geöffnet
ClickEmpfänger hat auf Link geklickt
SpamComplaintE-Mail als Spam markiert
SubscriptionChangeHinzufugung/Entfernung von Suppression-Liste
InboundEingehende E-Mail empfangen und geparst

Beispiel Bounce-Payload

{
  "RecordType": "Bounce",
  "ID": 692560173,
  "Type": "HardBounce",
  "TypeCode": 1,
  "Name": "Hard bounce",
  "Tag": "dns-report",
  "MessageID": "2c1b63fe-43f2-4db5-91b0-8bdfa44a9316",
  "ServerID": 23,
  "MessageStream": "outbound",
  "Description": "The server was unable to deliver your message",
  "Email": "ungueltig@captaindns.com",
  "From": "notifications@captaindns.com",
  "BouncedAt": "2026-01-28T16:09:19Z",
  "Inactive": true,
  "CanActivate": true
}

Retry-Richtlinie

Webhook-TypRetry-Richtlinie
Bounce, Inbound1 Min → 5 Min → 10 Min (x3) → 15 Min → 30 Min → 1 Std → 2 Std → 6 Std = 10 Retries über ca. 10,5 Std
Click, Open, Delivery1 Min → 5 Min → 15 Min = 3 Retries

Wichtig: Eine HTTP 403-Antwort stoppt die Retries sofort.

Sicherheit: HMAC-SHA256-Signatur

Jeder Webhook wird mit dem Header X-Postmark-Signature signiert.

Verifizierung (Node.js):

const crypto = require('crypto');

function verifyWebhookSignature(payload, signature, secret) {
  const computedSignature = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('base64');
  return crypto.timingSafeEqual(
    Buffer.from(computedSignature),
    Buffer.from(signature)
  );
}

Konfiguration über API

curl "https://api.postmarkapp.com/webhooks" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "X-Postmark-Server-Token: ihr-server-token" \
  -d '{
    "Url": "https://captaindns.com/webhooks/postmark",
    "MessageStream": "outbound",
    "Triggers": {
      "Delivery": { "Enabled": true },
      "Bounce": { "Enabled": true, "IncludeContent": false },
      "SpamComplaint": { "Enabled": true },
      "Open": { "Enabled": true, "PostFirstOpenOnly": true },
      "Click": { "Enabled": true }
    }
  }'

Technische Limits und Quotas

Nachrichtengröße

LimitWert
Max. E-Mail-Größe (API)10 MB gesamt
Max. Batch-Größe (Batch-API)50 MB gesamt
TextBody / HtmlBodyjeweils 5 MB
Nachrichtenspeicherung1 MB (darüber hinaus gekürzt)

API-Quotas

RessourceLimit
Empfänger pro E-Mailmax. 50 (To + Cc + Bcc)
Nachrichten pro Batchmax. 500
Webhook-URLs pro Streammax. 10
Tag-Größe1.000 Zeichen
Suche Bounces/Nachrichtenmax. 10.000 Ergebnisse

Datenaufbewahrung

TypDauer
Standard-Aufbewahrung45 Tage
Minimale Aufbewahrung7 Tage
Maximale Aufbewahrung365 Tage (Add-on)
Bounce-Dumpsmax. 30 Tage
Aggregierte StatistikenUnbegrenzt
Suppression-ListeUnbegrenzt

Templates mit Mustachio

Postmark verwendet Mustachio, eine auf Mustache basierende Templating-Sprache mit spezifischen Erweiterungen.

Grundlegende Syntax

<!-- Variable mit HTML-Escaping -->
{{ vorname }}

<!-- Variable ohne Escaping (raw) -->
{{{ html_content }}}

<!-- Punkt-Notation -->
{{ bestellung.nummer }}

Bedingungen (Truthy/Falsy-Blöcke)

{{#has_discount}}
  <p>Ihr Rabatt: {{ discount_amount }}</p>
{{/has_discount}}

{{^has_discount}}
  <p>Kein Rabatt angewendet</p>
{{/has_discount}}

Schleifen

{{#each items}}
  <li>{{ name }} - {{ price }} EUR</li>
{{/each}}

Einschränkungen:

  • Keine explizite if/else-Syntax
  • Komplexe Logik nicht unterstützt
  • <link>-Tags im <head> verboten
  • CSS wird beim Versand automatisch inline eingefügt

Sicherheit und Compliance

Zertifizierungen

ZertifizierungDetails
SOC 2 Type 2Nein - Zertifizierungen auf Rechenzentrumsebene (AWS, Deft)
ISO 27017/27018Über AWS
PCI DSS Level 1Über Stripe (Zahlungen)

DSGVO

AspektDetails
DPA verfügbarJa - mit SCCs
DPA-URLhttps://postmarkapp.com/dpa
DatenstandortUSA (keine EU-Option)
EU-VertreterEU-REP.Global

HIPAA

AspektDetails
HIPAA-konformNEIN
BAA verfügbarNEIN

Postmark erklärt ausdrücklich: "Postmark is not HIPAA-compliant so we do not recommend using our platform if you need to send HIPAA-compliant emails".

Konto-Authentifizierung

FunktionVerfügbarkeit
2FAJa - alle Pläne
SSO/SAMLNein - nicht verfügbar

Aktionsplan: Postmark Schritt für Schritt integrieren

  1. Konto erstellen auf https://account.postmarkapp.com/sign_up
  2. Freigabe beantragen über "Request approval" (ca. 24 Std. manuelle Prüfung)
  3. Domain verifizieren (individuelle Sender Signature oder vollständige Domain)
  4. DNS-Einträge konfigurieren:
    • DKIM: TXT [timestamp]pm._domainkey.captaindns.com
    • Return-Path: CNAME pm-bounces.captaindns.com → pm.mtasv.net
  5. Server-API-Token erstellen unter Settings → API Tokens
  6. Mit Test-Token testen: Verwenden Sie POSTMARK_API_TEST als Token zur Validierung ohne tatsächlichen Versand
  7. Webhooks konfigurieren für Bounces und Spam-Beschwerden
  8. Überwachen über den Activity Feed und die Statistiken

Technische Anleitungen: andere transaktionale E-Mail-Plattformen

Entdecken Sie unsere vollständigen Anleitungen für andere transaktionale E-Mail-Lösungen:

FAQ

Ist Postmark für E-Mail-Marketing geeignet?

Nein, Postmark ist auf transaktionale E-Mails spezialisiert. Broadcast-E-Mails (Newsletter, Ankündigungen) werden über separate Message Streams unterstützt, aber die Plattform bietet keine erweiterten Marketing-Funktionen (Segmentierung, A/B-Tests, Automation). Für Marketing sollten Sie dedizierte Lösungen oder die Mutterplattform ActiveCampaign in Betracht ziehen.

Was ist der Unterschied zwischen Postmark und SendGrid?

Postmark konzentriert sich ausschließlich auf transaktionale Zustellbarkeit mit einem streng kontrollierten IP-Pool. SendGrid bietet mehr Flexibilität (DKIM 2048 Bit, veröffentlichte Rate-Limits, mehr SDKs), aber mit einer allgemeineren Positionierung. Postmark verwendet 1024-Bit-DKIM-Schlüssel und veröffentlicht seine Rate-Limits nicht explizit.

Kann Postmark mit einer strikten DMARC-Richtlinie verwendet werden?

Ja, über DKIM. DKIM-Alignment unterstützt den Strict-Modus (adkim=s). Das SPF-Alignment funktioniert jedoch nur im Relaxed-Modus (aspf=r), da der Return-Path eine Subdomain verwendet. Konfigurieren Sie Ihre DMARC-Richtlinie so, dass sie sich auf DKIM stützt: p=reject; adkim=s; aspf=r.

Wie viel kostet eine dedizierte IP bei Postmark?

50$/Monat pro IP, ohne Einrichtungsgebuhr. Voraussetzung: mindestens 300.000 E-Mails/Monat versenden. Das Warm-up erfolgt automatisch über 3-6 Wochen. Für eine zusätzliche IP müssen 100.000 Nachrichten/Tag überschritten werden.

Gibt es ein offizielles Python-SDK für Postmark?

Nein, Postmark pflegt kein offizielles Python-SDK. Die empfohlenen Community-Alternativen sind postmarker und python-postmark. Die offiziellen SDKs decken Ruby, .NET, Java, PHP und Node.js ab.

Ist Postmark HIPAA-konform?

Nein. Postmark weigert sich ausdrücklich, BAAs (Business Associate Agreements) zu unterzeichnen. Wenn Sie PHI (Protected Health Information) versenden müssen, verwenden Sie eine andere HIPAA-konforme Lösung.

Glossar

  • Message Stream: Separater Versandkanal, der die Isolierung von transaktionalen E-Mails und Broadcasts ermöglicht, jeweils mit eigenem IP-Pool und eigenen Metriken
  • Sender Signature: Verifizierung einer individuellen Absender-E-Mail-Adresse als Alternative zur vollständigen Domain-Verifizierung
  • Return-Path: Bounce-Adresse (Envelope From), die von Empfangsservern für SPF und Bounce-Benachrichtigungen verwendet wird
  • Mustachio: Postmarks Templating-Sprache basierend auf Mustache, mit Unterstützung für Bedingungen, Schleifen und Variablen

Offizielle Quellen

Ähnliche Artikel