Zum Hauptinhalt springen

Postmark (ActiveCampaign): Technischer Leitfaden fur 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 ubernommen und setzt auf herausragende Zustellbarkeit mit strikter Trennung von transaktionalen/Broadcast-E-Mails uber Message Streams.
  • Einfache REST-API unter api.postmarkapp.com mit Header X-Postmark-Server-Token, maximal 50 Empfanger pro E-Mail, 500 Nachrichten pro Batch.
  • DKIM 1024 Bit mit Zeitstempel-Selektor ([timestamp]pm._domainkey), vierteljahrliche manuelle Rotation empfohlen.
  • Custom Return-Path uber CNAME pm-bounces.captaindns.compm.mtasv.net fur SPF-DMARC-Alignment ausschliesslich im Relaxed-Modus (kein Strict moglich).
  • Dedizierte IP fur 50$/Monat ab 300K E-Mails/Monat, automatisches Warm-up uber 3-6 Wochen.
  • Plane ab 15$/Monat fur 10K E-Mails (Basic), Free Developer Plan auf 100 E-Mails/Monat begrenzt.

Einfuhrung

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 ubernommen, bleibt der Dienst ein eigenstandiges Produkt mit eigenem Team und technischer DNA. Die Plattform verarbeitet Milliarden von E-Mails mit ausschliesslichem Fokus auf transaktionale Nachrichten (Bestellbestatigungen, Passwort-Zurucksetzungen, Benachrichtigungen).

Die Besonderheit von Postmark liegt in der strikten Trennung zwischen transaktionalen und Broadcast-E-Mails uber Message Streams. Diese Architektur garantiert, dass Ihre kritischen E-Mails niemals von Marketing-Kampagnen beeintrachtigt werden. Der gemeinsam genutzte IP-Pool wird aktiv uberwacht, um eine einwandfreie Reputation zu gewahrleisten.

Dieser Leitfaden richtet sich an Entwickler, DevOps-Ingenieure und Systemarchitekten, die Postmark mit einem vollstandigen Verstandnis der Infrastruktur integrieren mochten: 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 fur spezifische Anwendungsfalle 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-ahnlich)Nur Inline-Inhalt
SchedulingNativ nicht unterstutztNativ nicht unterstutzt
TrackingUber JSON-ParameterUber X-PM-*-Header
Idealer AnwendungsfallModerne Apps, Batch, TemplatesLegacy, CMS, bestehende Mailserver

Wann sollten Sie die REST-API wahlen?

Die REST-API ist die empfohlene Methode fur jede neue Integration. Sie bietet prazise Kontrolle uber 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

Vollstandiges 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 veroffentlicht, internes Monitoring
  • Empfanger: 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 wahlen?

SMTP-Relay ist ideal fur Legacy-Systeme oder Anwendungen, die nur SMTP unterstutzen.

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

Verfugbare Ports:

PortSupportHinweise
25JaSMTP-Standard
465NeinImplicit TLS nicht unterstutzt
587JaEmpfohlen - Submission-Port
2525JaAlternativer Port

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

Proprietare 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-TrackOpensOffnungs-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-Schlussel mit einem eindeutigen Zeitstempel-basierten Selektor.

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

Beispiele fur 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:

  • Schlusselgrosse: 1024 Bit (nicht 2048)
  • Rotation: manuell, vierteljahrlich 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 Ubergang gewahrleistet.

SPF: erforderlich oder nicht?

SPF ist fur Postmark nicht mehr erforderlich. Hier ist der Grund:

Standardmassig verwendet Postmark seine eigene Domain fur den Return-Path:

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

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

Optionaler Include (wenn Sie explizit sein mochten):

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

Custom Return-Path und DMARC-Alignment

Um SPF-DMARC-Alignment zu erreichen, mussen 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 - schlagt fehl
Custom Return-PathJa (Kunden-Subdomain)Ja - nur Relaxed

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

Empfohlene Strategie: Verlassen Sie sich auf DKIM fur DMARC-Alignment, das den Strict-Modus (adkim=s) unterstutzt.

Vollstandige DNS-Ubersichtstabelle

EintragTypHostnameWertErforderlich
DKIMTXT[timestamp]pm._domainkey.captaindns.comk=rsa; p=[offentlicher-schlussel]Ja - empfohlen
Return-PathCNAMEpm-bounces.captaindns.compm.mtasv.netFur 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 uber Message Streams. Diese Architektur schutzt 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

Fur 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 fur mehr kontaktieren)
Inbound-Streams pro Servernur 1
Stream-Namemax. 100 Zeichen
Archivierte StreamsLoschung nach 45 Tagen

Shared IP vs. Dedizierte IP

Shared IP-Pool (alle Plane)

Standardmassig nutzen alle Postmark-Kunden einen hochreputierten Shared IP-Pool.

Postmark-Philosophie: "Ein hochwertiger, hochreputierter IP-Pool bietet fur die Mehrheit der Versender eine bessere und zuverlassigere Zustellbarkeit".

Eigenschaften:

  • Aktiv uberwachter Pool
  • Automatische Blacklist-Warnungen
  • Kein Warm-up erforderlich
  • Geeignet fur die meisten Volumen

Dedizierte IP

Fur hohe Volumen bietet Postmark dedizierte IPs an.

KriteriumWert
Mindestvolumen300.000 E-Mails/Monat
Kosten50$/IP/Monat (keine Einrichtungsgebuhr)
Zusatzliche IP100.000+ Nachrichten/Tag erforderlich
Warm-upAutomatisch, 3-6 Wochen
OverflowWahrend des Warm-ups uber Shared Pool geroutet

Automatisches Warm-up:

  • Von Postmark festgelegte tagliche Limits
  • Anpassung basierend auf der Reaktion der Empfanger
  • Uberschussiges Volumen wird uber 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 fallt.

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

Preise 2026

Plane 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 moglich
  • Ideal fur 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 zusatzliche E-Mail
  • Sandbox-Nachrichten = werden gezahlt
  • Nicht genutzte E-Mails = werden nicht ubertragen

Webhooks und Events

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

Postmark Webhook-Architektur

Verfugbare Events

EventBeschreibung
DeliveryE-Mail an Empfangsserver zugestellt
BounceE-Mail zuruckgewiesen (Hard, Soft, Transient)
OpenEmpfanger hat E-Mail geoffnet
ClickEmpfanger 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 uber 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 uber 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

Nachrichtengrosse

LimitWert
Max. E-Mail-Grosse (API)10 MB gesamt
Max. Batch-Grosse (Batch-API)50 MB gesamt
TextBody / HtmlBodyjeweils 5 MB
Nachrichtenspeicherung1 MB (daruber hinaus gekurzt)

API-Quotas

RessourceLimit
Empfanger pro E-Mailmax. 50 (To + Cc + Bcc)
Nachrichten pro Batchmax. 500
Webhook-URLs pro Streammax. 10
Tag-Grosse1.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-Blocke)

{{#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}}

Einschrankungen:

  • Keine explizite if/else-Syntax
  • Komplexe Logik nicht unterstutzt
  • <link>-Tags im <head> verboten
  • CSS wird beim Versand automatisch inline eingefugt

Sicherheit und Compliance

Zertifizierungen

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

DSGVO

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

HIPAA

AspektDetails
HIPAA-konformNEIN
BAA verfugbarNEIN

Postmark erklart ausdrucklich: "Postmark is not HIPAA-compliant so we do not recommend using our platform if you need to send HIPAA-compliant emails".

Konto-Authentifizierung

FunktionVerfugbarkeit
2FAJa - alle Plane
SSO/SAMLNein - nicht verfugbar

Aktionsplan: Postmark Schritt fur Schritt integrieren

  1. Konto erstellen auf https://account.postmarkapp.com/sign_up
  2. Freigabe beantragen uber "Request approval" (ca. 24 Std. manuelle Prufung)
  3. Domain verifizieren (individuelle Sender Signature oder vollstandige Domain)
  4. DNS-Eintrage konfigurieren:
    • DKIM: TXT [timestamp]pm._domainkey.captaindns.com
    • Return-Path: CNAME pm-bounces.captaindns.compm.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 tatsachlichen Versand
  7. Webhooks konfigurieren fur Bounces und Spam-Beschwerden
  8. Uberwachen uber 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 fur E-Mail-Marketing geeignet?

Nein, Postmark ist auf transaktionale E-Mails spezialisiert. Broadcast-E-Mails (Newsletter, Ankundigungen) werden uber separate Message Streams unterstutzt, aber die Plattform bietet keine erweiterten Marketing-Funktionen (Segmentierung, A/B-Tests, Automation). Fur Marketing sollten Sie dedizierte Losungen oder die Mutterplattform ActiveCampaign in Betracht ziehen.

Was ist der Unterschied zwischen Postmark und SendGrid?

Postmark konzentriert sich ausschliesslich auf transaktionale Zustellbarkeit mit einem streng kontrollierten IP-Pool. SendGrid bietet mehr Flexibilitat (DKIM 2048 Bit, veroffentlichte Rate-Limits, mehr SDKs), aber mit einer allgemeineren Positionierung. Postmark verwendet 1024-Bit-DKIM-Schlussel und veroffentlicht seine Rate-Limits nicht explizit.

Kann Postmark mit einer strikten DMARC-Richtlinie verwendet werden?

Ja, uber DKIM. DKIM-Alignment unterstutzt 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 stutzt: 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 uber 3-6 Wochen. Fur eine zusatzliche IP mussen 100.000 Nachrichten/Tag uberschritten werden.

Gibt es ein offizielles Python-SDK fur 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 ausdrucklich, BAAs (Business Associate Agreements) zu unterzeichnen. Wenn Sie PHI (Protected Health Information) versenden mussen, verwenden Sie eine andere HIPAA-konforme Losung.

Glossar

  • Message Stream: Separater Versandkanal, der die Isolierung von transaktionalen E-Mails und Broadcasts ermoglicht, jeweils mit eigenem IP-Pool und eigenen Metriken
  • Sender Signature: Verifizierung einer individuellen Absender-E-Mail-Adresse als Alternative zur vollstandigen Domain-Verifizierung
  • Return-Path: Bounce-Adresse (Envelope From), die von Empfangsservern fur SPF und Bounce-Benachrichtigungen verwendet wird
  • Mustachio: Postmarks Templating-Sprache basierend auf Mustache, mit Unterstutzung fur Bedingungen, Schleifen und Variablen

Offizielle Quellen

Ähnliche Artikel