Repository navigation
v2.27.0 — MailerSend
MailerSend is the seventh provider
Postmaster now handles MailerSend: webhooks, delivery tracking, suppression sync, the dashboard, resend, and sandbox release. It needs no MailerSend SDK.
-
Webhooks. In MailerSend, create a version 2 webhook that sends to
/webhooks/postmaster/mailersend, then set its signing secret:POSTMASTER_MAILERSEND_SIGNING_SECRET=...
Each domain's webhook has its own secret; separate several with commas. MailerSend's test request, sent when you save a webhook, is accepted before you've set the secret.
-
Sending. Webhooks match mail sent through mailersend/laravel-driver, Symfony's
mailersend+apitransport, or SMTP throughsmtp.mailersend.net. -
Suppression sync reads MailerSend's hard bounces, spam complaints, unsubscribes, and blocklisted addresses. Unsuppressing an address removes it from MailerSend too. Sync uses the driver's
MAILERSEND_API_KEY, orPOSTMASTER_MAILERSEND_API_KEY. The token needs full access to Suppressions. SetPOSTMASTER_MAILERSEND_DOMAIN_IDto sync one domain.
php artisan postmaster:install detects MailerSend and walks you through setup. See docs/mailersend.md for details and live test results.
Known gap: MailerSend skips suppressed recipients at send time, and Postmaster can't always see that, so those rows can stay at "sent". Turn on POSTMASTER_BLOCK_SUPPRESSED and run sync to avoid sending to them. (mailersend/mailersend-laravel-driver#95)
Upgrading
No migrations.