Postmark

Postmark Outbound

Postmark Inbound

Configure an Inbound Server

1. Create a new server in Postmark.

Configuring Postmark's Inbound API is similar to the same way you may have already configured your Outbound API or SMTP servers. A single server can be created to process and track activity for each of your applications and environments. In addition, you can use the same server for both Inbound and Outbound email.

2. GET the server details and InboundHash.

The next step is to figure out your unique InboundHash where you can forward your email. This can be found in the web app in your server's Credentials tab or via the API.

Inbound Email Configuration

You can also do this via our API:

$: curl -X GET "https://api.postmarkapp.com/server"  \
      -H "Accept: application/json" \
      -H "Content-Type: application/json" \
      -H "X-Postmark-Server-Token: [TOKEN]"

In this API call, the [TOKEN] is the unique API token provided with each Postmark server. The response should look something like this:

{
  "Name": "Kermit",
  "Color": "green",
  "InboundHash": "451d9b70cf9364d6f9d51sdf34343sdf343"
  "SmtpApiActivated": false
}

The field InboundHash is the email inbox we use to identify incoming email for this server. For instance, we collect any email sent to your_hash@inbound.postmarkapp.com and parse it in this server.

3. Send to Postmark Inbound using your own email address

Depending on your use, you will probably not want your users to see this email. Our MX Record Support is in beta (contact us for details). In the mean time, or if you do not have access to edit your DNS records, you can read our help article to learn how to configure a custom forwarding email address from your Gmail/Google Apps account.

4. Set the URL where we should send JSON data.

In order for your application receive the emails that we parse, you will need to tell Postmark where to send the JSON data for each inbound email it processes, which is done via an HTTP POST to a URL of your choice. You can set this URL in the Settings page for your Postmark server in the web app, or using the InboundHookUrl field in the API.

To test your inbound server, we recommend using a RequestBin first. Here is an example of setting a hook URL via the API in curl:

$: curl -X POST "https://api.postmarkapp.com/server" \
      -H "Accept: application/json" \
      -H "Content-Type: application/json" \
      -H "X-Postmark-Server-Token: [TOKEN]" \
      -d "{ 'InboundHookUrl': 'http://requestb.in/1crksas1' }"

If you get your server details again, it should now look something like this:

{
    "Name": "Kermit",
    "Color": "green",
    "InboundHookUrl": "http://requestb.in/1crksas1",
    "SmtpApiActivated": false
}

Once emails are being sent to RequestBin successfully, your inbound server has been configured correctly and you're ready to start parsing email for your application.