Bring Your Own Domains
Let CustomerOS optimise email deliverability from your domains directly
If you already have domains ready for sending emails, you can still use CustomerOS to setup mailboxes, manage DNS and monitor deliverability for you as part of our Mailstack product.
For CustomerOS to manage your DNS and make changes without you needing to manually change anything, we have built an integration with Cloudflare. The following steps will make sure that you are ready to integrate your domains with CustomerOS and carry out the integration.
1. Check your DNS provider
The reason we have chosen to partner with Cloudflare to provide this service is they provide programmatic access to control DNS settings, as well as doing this under a free plan for all required functionality required to run, monitor and maintain deliverabilty through Mailstack.
If you are not currently with Cloudflare you should sign up for an account, unless you are using enterprise features you should find all services included in their generous free plan.
If you are unsure which DNS provider you are with, you can easily check through your domain registrar where your nameservers are. If you don’t have access to your domain registrar, you can use these two methods:
- Use a tool like MXToolbox or DNS Checker.
- Check from your terminal on OSX or Linux using
dig example.com
where in this example you would return example.com’s DNS settings.
These methods will return the DNS nameserver, and if it doesn’t look like evelyn.ns.cloudflare.com
or norm.ns.cloudflare.com
then you will need to migrate your domain’s DNS over to Cloudflare from the provider in the domain.
2. Prepare your domain with Cloudflare
After creating a Cloudflare account follow the prompts after clicking the + Add a Domain
button on the main page under the Domains tab to migrate your domain DNS to Cloudflare.
DNS may take up to 24 hours for the updates to which nameservers your domain uses to fully propagate globally. You can continue with the next steps but please be aware that some issues may occur while these changes are made to global internet routing.
3. Create Cloudflare API token
To give access to CustomerOS to manage specific domains for you, you should generate a Cloudflare token from the Cloudflare dashboard using this link. The link will prefill the required scopes for your review, as well as allowing you to specify the Cloudflare zones (essentially domains) that you want CustomerOS to manage.
CustomerOS won’t do anything with the domains you specify, however it is good practice to limit access only to the domains you wish to use with Mailstack.
Once you have generated a token with the link, you should then add it to CustomerOS via the settings page
4. Link Domain, Set users & redirect
Using the token, CustomerOS will identify which domains are suitable for configuring Mailstack on. Select the domains you want to use for Mailstack and then provide the 2 usernames of the mailboxes you would like to send email from (such as matt@ and matt.brown@) and the redirect of your domain to your primary domain.
That’s it! You now have configured your own domain to be managed by CustomerOS. You will have constant monitoring for deliverability issues and automatic updates to your domain to maintain great deliverability automatically!
Happy sending!