Skip to content

v2.27.0 — MailerSend

Choose a tag to compare

@jszobody jszobody released this 03 Oct 23:47
· 5 commits to master since this release
5f6ad55

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+api transport, or SMTP through smtp.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, or POSTMASTER_MAILERSEND_API_KEY. The token needs full access to Suppressions. Set POSTMASTER_MAILERSEND_DOMAIN_ID to 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.