Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Postmark plugin for CakePHP

branch: master

Postmark plugin for CakePHP

CakePHP plugin that makes email delivery using Postmark


Written for CakePHP 2.x


Copyright (c) 2011 Maury M. Marques


You can clone the plugin into your project (or if you want you can use as a submodule):

cd path/to/app/Plugin or /plugins
git clone Postmark

Bootstrap the plugin in app/Config/bootstrap.php:



Create the file app/Config/email.php with the class EmailConfig.

class EmailConfig {
    public $postmark = array(
        'transport' => 'Postmark.Postmark',
        'uri' => '',
        'key' => 'your-postmark-key'

If you want your connection to Postmark to be encrypted, simply change the uri to use https.

Make sure to modified the API key to match the credentials for your Postmark server rack instance.


This plugin uses CakeEmail, and works virtually the same.

Then, simply send messages like this:

App::uses('CakeEmail', 'Network/Email');
$email = new CakeEmail();

$email->subject('Test Postmark');

Or use more resources:

App::uses('CakeEmail', 'Network/Email');
$email = new CakeEmail();

$email->template('default', 'default');
$email->viewVars(array('name' => 'Your Name'));
$email->from(array('' => 'Your Name'));
$email->to(array('' => 'Recipient1', '' => 'Recipient2'));
$email->cc(array('' => 'Recipient3', '' => 'Recipient4'));
$email->bcc(array('' => 'Recipient5', '' => 'Recipient6'));
$email->subject('Test Postmark');
$email->addHeaders(array('Tag' => 'my tag'));
    'cake.icon.png' => array(
        'file' => WWW_ROOT . 'img' . DS . 'cake.icon.png'


If you need the instance of the class PostmarkTrasport:

App::uses('CakeEmail', 'Network/Email');
$email = new CakeEmail();

$postmarkInstance = $email->transport('Postmark.Postmark')->transportClass();

The syntax of all parameters is the same as the default CakeEmail:

For more information, see the Postmark API documentation:


You can see the response from Postmark in the return value when you send a message:

$result = $email->send('Message');
$this->log($result, 'debug');

If there are any errors, they'll be included in the response. See the Postmark API documentation for error code detail:

CakePHP 1.3+

This class does not work for CakePHP 1.3, for this see:

Something went wrong with that request. Please try again.