Getting Started

Getting started with Postmark is very easy. In order to start using full potential of Postmark API, you will need to:

• Signup for a new account
• Retrieve a Server API token, from one of the servers you created in your account
• Retrieve an Account API token (optional)
• Create a sender signature

Account API token is needed only for admins, for managing account details like domains, signatures, etc. To read more about tokens, check out our developer docs.

Sending your first email

Sending email with Postmark is super easy, check out the following code example.

The example shows code in Javascript ES5:

var postmark = require("postmark");
var serverToken = "xxxx-xxxxx-xxxx-xxxxx-xxxxxx";
var client = new postmark.ServerClient(serverToken);

client.sendEmail(
    {
        From: "[email protected]",
        To: "[email protected]",
        Subject: "Hello from Postmark!",
        HtmlBody: "Hello message body."
    }
, function(err, data) {
        console.log(err)
        console.log(data) });

Same example using Javascript ES6 code:

let postmark = require("postmark");
const serverToken = "xxxx-xxxxx-xxxx-xxxxx-xxxxxx";
let client = new postmark.ServerClient(serverToken);

client.sendEmail(
    {
        From: "[email protected]",
        To: "[email protected]",
        Subject: "Hello from Postmark!",
        HtmlBody: "Hello message body."
    }
).then(response => {
    console.log("Sending message");
    console.log(response.To);
    console.log(response.Message);
});

Please note that in the code example above you need to change to a server token from your account, and you need to change to a verified signature (from address), you created in your account.

To use the full potential of the library, we recommend using Typescript. Detailed documentation of each library method with additional details about types when using typescript can be found here.

To check out more examples about sending with library, check out email sending section. It should help you going quickly with library usage.