The Return-Path header shows where smtp events and bounce messages should be sent. By default, this address points to mandrillapp.com, but you can customize the address to point to your own domain instead.
Even if you use a custom Return Path domain, Transactional Email still handles the bounces. If you need to receive bounce details in your own application or to a specific email address, you can set up webhooks and Transactional Email will send information to your webhook URL when these events occur. From there, you can process the events as needed in your application/database or use code to forward the bounce information along in a new email.
Add a Custom Return Path Domain
Before getting started, set up a CNAME record pointing your subdomain to mandrillapp.com. The domain must be a subdomain (like mail.yourdomain.com) and can not be a root domain (like yourdomain.com). You can use any valid tracking domain as a Return Path domain, but we suggest creating a unique subdomain specifically for this purpose.
Save the Return Path Domain in Transactional Email
- Go to Settings.
- Choose Tracking & Return Path Domains, enter your subdomain, and then click Add.
- Click Test DNS Settings to verify the settings for the subdomain you added.
Enable a Custom Return Path Domain
You can enable a custom return path domain on a per-message basis using the return_path_domain
parameter (API), X-MC-ReturnPathDomain
(SMTP), or globally for your account under on the Sending Defaults page. Global account settings apply for all emails by default, but if the API call or SMTP headers have different tracking options, this will override the default account setting.
Notes
- Each DNS provider/host may handle adding or editing records differently, so your host's technical support or documentation is the best resource for any limitations or formatting specific to that provider.
- Some DNS providers take longer than others to publish and push the record. If you are adding a new record, those often validate in several minutes. Changing records can take longer, but can vary based on your DNS provider and TTL for the record.
- You can only add a Return Path domain to one Transactional Email account. Additions to a different Transactional Email account will result in an error. If you have a specific use-case for a Return Path domain being used across multiple Transactional Email accounts, contact Transactional Email support.