Search by

flipboxfactory / craft-postmark

brandonkellynateilerbenface

This package is abandoned and no longer maintained. The author suggests using the craftcms/postmark package instead.

Postmark adapter for Craft CMS

Package info

github.com/craftcms/postmark

Documentation

Type:craft-plugin

pkg:composer/flipboxfactory/craft-postmark

Statistics

Installs: 3 193

Dependents: 1

Suggesters: 0

Stars: 20

Open Issues: 4

3.2.0 2026-11-12 09:37 UTC

This package is auto-updated.

Last update: 2026-11-12 09:37:33 UTC


README

Postmark icon

Postmark for Craft CMS

This plugin provides a Postmark integration for Craft CMS.

Requirements

This plugin requires Craft CMS 4.0.0+ or 5.0.0+, or 6.0.0-beta.1+ with the craftcms/yii2-adapter package.

Installation

You can install this plugin from the Plugin Store or with Composer.

From the Plugin Store

Go to the Plugin Store in your project’s Control Panel and search for “Postmark”. Then click on the “Install” button in its modal window.

With Composer

Open your terminal and run the following commands:

# go to the project directory
cd /path/to/my-project.test

# tell Composer to load the plugin
composer require craftcms/postmark

# tell Craft to install the plugin
./craft plugin/install postmark

Setup

Once Postmark is installed:

  1. Go to Settings → Email.
  2. Change the Transport Type setting to Postmark. Also, ensure that your System Email Address in your Craft Email Settings matches your confirmed Sender Signature email address in Postmark.
  3. Enter your Server Token (which you can get from your server page under “API Tokens”).
  4. If you wish to send mail using a custom Message Stream, set the Message Stream ID. (The default transactional Message Stream will be used if this is left blank.)
  5. Click Save.

Tip: The Server Token and Message Stream ID settings can be set using environment variables. See Environmental Configuration in the Craft docs to learn more about that.

Craft 6

Craft 6 sends email through Laravel mailers. Laravel has its own Postmark driver, so you don’t need this plugin once you’ve configured it.

With the craftcms/yii2-adapter package installed, Craft can keep sending email through the Postmark settings in your project config, as the craft-transport mailer. Craft logs a deprecation warning while it does this.

To send email through this plugin, set MAIL_MAILER=craft-transport in your environment, or select craft-transport as the Mailer in Settings → Email. MAIL_MAILER applies to all email. The Settings → Email mailer applies to email that Craft sends, such as system messages and test emails. If you do neither, Craft only uses craft-transport while MAIL_MAILER isn’t set and config/mail.php still defaults to log. New Craft 6 projects set MAIL_MAILER=log, which writes email to the log instead of sending it.

To configure Laravel’s Postmark driver:

  1. Require Symfony’s Postmark transport and HTTP client. Removing this plugin removes them too, otherwise.

    composer require symfony/postmark-mailer symfony/http-client
  2. Check that the mailers array in config/mail.php has a postmark mailer. If you set a Message Stream ID, add message_stream_id, which Laravel’s default config leaves commented out. Without it, Postmark uses the default transactional Message Stream.

    'postmark' => [
        'transport' => 'postmark',
        'message_stream_id' => env('POSTMARK_MESSAGE_STREAM_ID'),
    ],
  3. Check that config/services.php has your Server Token. Projects upgraded from Craft 5 read POSTMARK_TOKEN, as below; new Craft 6 projects read POSTMARK_API_KEY, with a key setting. Either works.

    'postmark' => [
        'token' => env('POSTMARK_TOKEN'),
    ],
  4. Set the environment variables in .env.

    MAIL_MAILER=postmark
    POSTMARK_TOKEN=your-server-token
    POSTMARK_MESSAGE_STREAM_ID=your-message-stream-id
  5. Send a test email from Settings → Email, or with php artisan craft:mailer:test.

Then uninstall the plugin and remove it from your project:

php artisan craft:plugin:uninstall postmark
composer remove craftcms/postmark