Postmark Integration

How to use Postmark with MagicBell

Deliver email notifications with your Postmark account

To configure Postmark for your MagicBell project, follow these steps:

  1. Sign up for Postmark and obtain a server API token.
  2. Verify your sender signature in Postmark.
  3. From the Settings > Providers page in your dashboard, select Postmark.
  4. Enable the provider and enter the API key from step 1 then click Save.
You can optionally configure a custom from email address (verified sender signature) and name.

Once your account is set up, MagicBell will automatically deliver email notifications through your Postmark account, no additional work is needed.

Please keep in mind that MagicBell automatically injects both notification_id and broadcast_id in the metadata of messages sent to Postmark.

Provider Overrides

Our create notifications endpoint allows you to customize the payload sent to Postmark by setting notification.overrides.

The notification.overrides.postmark parameter accepts all the body parameters of Postmark's Email API.

Provider-specific parameters in notification.overrides take precedence over the ones specified in notification.

Example: Tag an email and set a custom header

{
  "notification": {
    "title": "Welcome to MagicBell",
    "content": "The notification inbox for your product. Get started in minutes.",
    "category": "signup",
    "action_url": "https://developer.magicbell.com",
    "recipients": [
      {
        "email": "[email protected]"
      }
    ],
    "overrides": {
      "providers": {
        "postmark": {
          "Tag": "signup",
          "Headers": {
            "X-Original-To": "[email protected]"
          }
        }
      }
    }
  }
}
Email us if you wish to use Postmark templates!