Postmark Integration

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 → Channels page in your dashboard, select Add Provider → Postmark.
4. Enable the provider and enter the API key from step 1 then click Save.

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]"
          }
        }
      }
    }
  }
}