Creating a Custom Bounce Domain

April 29, 2017 Contributors

You can improve your deliverability and email branding by configuring each of your sending domains as bounce domains. A bounce domain provides another layer to the branding that some ISPs care about.

By using your sending domain as your bounce domain, you can customize the address that is used for the Return-Path header (which denotes the destination for out-of-band bounces). This bounce domain overrides the default Return-Path (also known as the envelope FROM) value of "sparkpostmail.com" for all messages sent.

To configure a bounce domain, choose the subdomain you would like to use (e.g. mail.yourdomain.com) and add the following CNAME record to your DNS settings:

Hostname Type Value
mail.yourdomain.com CNAME sparkpostmail.com

This DNS record will ensure that out-of-band/asynchronous bounces are routed to SparkPost for processing.

Once you have configured your DNS settings, register and verify the domain with SparkPost by following the steps below:

  1. Register the domain with SparkPost by using the sending domains create endpoint

  2. CNAME-verify the domain by using the sending domains verify endpoint. Here’s an example API call to CNAME-verify the mail.example.com domain:

    POST /api/v1/sending-domains/mail.example.com/verify
    
    {
      "cname_verify" : true
    }
    
  3. Optionally set the domain as your account default bounce domain so that it is automatically used as the bounce domain for all messages sent through the account. Here’s an example API call to set mail.example.com as the account default bounce domain:

    PUT /api/v1/sending-domains/mail.example.com
    
    {
      "is_default_bounce_domain" : true
    }
    

Alternately, you may configure multiple CNAME-verified sending domains and select one as the bounce domain on a per message basis by including it in the transmission return_path field for transmission requests using the REST API, or by specifying it in the SMTP MAIL FROM command for SMTP injections.

After CNAME-verifying or marking the domain as the account default bounce domain, there is up to a 5 minute delay for compliance verification before the domain may be used as a message’s bounce domain.

If you prefer to use the SparkPost app, then you can create a single bounce domain that will be used for all of your outgoing mail.

  1. Select Account and then Bounce Domains from the main menu.
  2. Click the New Domain button to add a new bounce domain.
  3. Add bounce domain
  4. Select test
  5. Make sure the domain is verified by the green check mark