Postmark

Overview

Integration

User guide

API reference

Webhooks

Inbound domain forwarding

If you have access to your DNS records, Postmark includes a simple way for you to configure your MX records to point to our mail servers. If you do not have access to your DNS records, we support email being forwarded by 3rd party mail services.

1. Set an MX Record

Choose a domain that you would like to listen on for incoming email to be processed by Postmark. We recommend a separate subdomain, like inbound.yourdomain.com. In your DNS configuration, create an MX record that points to inbound.postmarkapp.com and give it a value of 10.

Example DNS configuration

2. Set the domain

Inbound domains are unique across Postmark and are server-specific. You can configure the Inbound Domain on the server settings page.

Set the Inbound Domain using the UI

Alternatively, you can use the Server API to set the Inbound Domain on your server.

3. Enable SMTP

Enable SMTP on the server’s credential page.

4. Send emails

You should now be able to send emails to any address for @inbound.yourdomain.com

Example request with curl

curl "https://api.postmarkapp.com/servers/:serverid" \
  -X PUT \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-Postmark-Account-Token: account token" \
  -d "{InboundDomain: 'inbound.yourdomain.com'}"

Example JSON response

{
  "Name": "Production Testing",
  "Color": "blue",
  "SmtpApiActivated": false,
  "RawEmailEnabled": false,
  "InboundHookUrl": "http://hooks.example.com/inbound",
  "BounceHookUrl": "http://hooks.example.com/bounce",
  "OpenHookUrl": "http://hooks.example.com/open",
  "PostFirstOpenOnly": false,
  "InboundDomain": ""
}