Getting Started

Remember CloudMailin Outbound is only for Transactional email More information can be found in the outbound email introduction.

This will mainly consist of:

  1. Creating DNS records
  2. Setting your SMTP server access credentials
  3. Monitoring Bounces (highly recommended)
  4. Setting Queue Priorities (optional)
  5. Setting message tags (optional)

DNS Records

We currently require DNS records for SPF, DKIM and to handle bounces. This can all be set using two records.

Normally we will ask to send on a subdomain of your primary domain. For example if your domain is example.com then we will send from mta.example.com.

The SMTP conversation will send the message from bounces+12345@mta.example.com whilst the message headers remain as user@example.com.

We need to set the following DNS records (these are just examples):

Record Example Description
CNAME mta.example.com A CNAME used to set MX servers for bounces and SPF
TXT 1234._domainkeys.example.com The DKIM record placed on the root example.com domain.

Details for your domain specifically cen be found on the domain's detail page.

SMTP Settings

SMTP settings will be available from within the dashboard of your account. Currently we require TLS to allow our self issued certificates. This might require VERIFY_PEER to be turned off in OpenSSL.

The SMTP transaction will reply with the message-id of the message to use for bounce tracking if required.

250 Thanks! Queued as: f78b876d-dd97-4e10-9a61-067f98044cc7

Monitoring Bounces

Our system will track bounces and non-delivery-reports from mail servers. These events will be sent to you via Webhook. The payload will be a JSON HTTP request with the following format:

{
  "events": [
    {
      "kind": "bounce",
      "recipient": "user@example.net",
      "message_id": "f78b876d-dd97-4e10-9a61-067f98044cc7",
      "details": {}
    }
  ]
}

Please note: The list of events is an array. In multiple events may be sent in one HTTP POST.

The list of fields currently POSTed for each entry is as follows:

Field Description
kind The type of event raised. This is one of delivery, bounce, soft_bounce, open, click, complaint, blocked.
recipient The recipient of the message.
message_id The message ID as returned by the SMTP transaction.
details Additional details if present related to the event.

These fields will be expended with additional details over time.