create_domain, verify_domain, update_domain, and
get_domain_health over MCP run this page
without the dashboard, for a marketing domain. MCP can’t set or change a
domain’s sending purpose: do that in the app or over HTTP.
Over HTTP it is POST /v1/domains (which takes
sendingPurpose), POST /v1/domains/{domainId}/verify, and
PATCH /v1/domains/{domainId} to change the purpose later.
get_domain_health (GET /v1/domains/{domainId}/health) also reads the
domain’s deliverability score. include: ["scoreHistory", "scoreRuns"]
adds up to 50 saved score snapshots and the last 5 automated score runs.
How to Verify
mail.yourdomain.com keeps deliverability problems away from your root domain, and it shows in the From field. See Best practices for the rest.Add your sending domain
updates.acme.com instead of acme.com.Good subdomain options:mail.yourdomain.comupdates.yourdomain.comnews.yourdomain.com
Choose the sending purpose
- Marketing (the default): newsletters, announcements, promotions, and lifecycle flows.
- Transactional: mail a person triggered themselves, such as a password reset or a receipt.
Set default sender details
- Sender name. Appears next to your email address. Keep it personal (a real name works well).
- From email. The address in the “From” field.
- Reply-to email. Where replies land. Use a monitored address, never
no-reply. Replies signal value to inbox providers and improve your deliverability.
Add DNS records
- Connect automatically (recommended)
- Zone file
- Manual setup
- Click Connect automatically.
- A window opens to your DNS provider (Cloudflare, Vercel, GoDaddy, Namecheap, and most others are supported). Sign in and approve.
- Brew writes the DKIM, SPF, and DMARC records into your zone. Nothing else in your zone changes.
- The records verify on their own and turn green.
Records You’ll Add
Brew groups the records in two sets. The four Required to send records must all be found before the domain can send. The two Recommended records aren’t needed to send, but both help your mail reach the inbox.DKIM (required)
DKIM (required)
SPF (required)
SPF (required)
Sending CNAME (required)
Sending CNAME (required)
DMARC (recommended)
DMARC (recommended)
dmarc_missing) or an invalid one (dmarc_invalid), meaning malformed or more than one record.Link tracking (recommended)
Link tracking (recommended)
Provider-specific instructions
Provider-specific instructions
mail, with no period at the start or end. For MX records, use the priority Brew shows. If you see an “invalid hostname” error, try adding a period (.) at the end of the value. GoDaddy helpCloudflare. Sign in, select your domain, go to DNS → Records, and click Add record. Set Proxy status to DNS only (gray cloud) on each CNAME record. MX and TXT records have no proxy setting. Cloudflare helpSquarespace (formerly Google Domains). Sign in, select your domain, and open DNS → DNS Settings. Scroll to Custom Records and click Add record. Squarespace adds your domain to the Name field for you, so enter only the part before it. Google Domains registrations migrated here, so this is where they live now. Squarespace helpNamecheap. Sign in, open Domain List → Manage for your domain, then the Advanced DNS tab. In Host, enter only the subdomain part, not your domain name. Click Save All Changes when you’re done. If you use Gmail/Google Workspace, switch Mail Settings to Custom MX before adding Brew’s MX records, then re-add Gmail’s MX record. Namecheap helpAWS Route 53. Sign in, select your hosted zone, and click Create record. For MX records, put priority and value together, such as 10 mail.example.com. Wrap TXT values in double quotes, and split any value over 255 characters into several quoted strings on one line. AWS helpVercel. Sign in, open Domains and select your domain. Use only the subdomain part for record names. This works only if the domain uses Vercel’s nameservers. Otherwise add the records where your DNS is hosted. Vercel helpWix. Wix supports MX records on a subdomain that isn’t connected to a Wix site. Go to Domains, click the Domain Actions icon next to your domain, then Manage DNS records. Under Other MX records, click + Add Record and enter only the subdomain part in Host name. Wix helpDreamHost. Open the Custom MX page in the panel and click Edit next to your subdomain. Enter the MX record with the priority first, such as 10 mail.example.com, with no @ or trailing period. Then click Change this domain to use custom MX records now! This turns off DreamHost email for that subdomain only. Add the TXT and CNAME records as custom DNS records. DreamHost helpDon't have access to your domain registrar?
Don't have access to your domain registrar?
- Add a teammate with DNS access to your Brew account
- Share this guide with your IT team
MX record conflicts
MX record conflicts
mail.yourdomain.com), remove it before adding Brew’s.The MX record is for your sending subdomain, not your root domain. It won’t affect existing email on your root domain.If you need to keep the existing MX record, pick a different subdomain (for example, newsletter.yourdomain.com). Add it from Domains in the sidebar and re-run verification.Verify your records
Best Practices
Use a subdomain
Use a subdomain
mail.yourdomain.com instead of your root domain protects your main domain’s reputation. If deliverability issues happen on a subdomain, you can isolate the problem without affecting the rest of your business.The subdomain you choose appears in the From field, so pick something recognizable.Use a real reply address
Use a real reply address
hello@company.com or support@company.com and have someone monitor them. Replies signal to inbox providers that your content is valuable.Align link domains with your sending domain
Align link domains with your sending domain
bit.ly in marketing emails.FAQ
Can I change my sending domain later?
Can I change my sending domain later?
Why does it say my domain is already in use?
Why does it say my domain is already in use?
- Find who set up the original Brew account on your team
- Ask them to invite you
- If you believe this is wrong, email support@brew.new with proof of domain ownership
What if I don't own a domain?
What if I don't own a domain?
Can I change a domain's sending purpose?
Can I change a domain's sending purpose?
PATCH /v1/domains/{domainId} with a new sendingPurpose.
Change a Domain’s Purpose
covers what happens to emails and automations that still point at it.Do I need a separate domain for transactional email?
Do I need a separate domain for transactional email?
When do I need to repeat this?
When do I need to repeat this?
Need Help?
Our team is ready to support you at every step of your journey with Brew. Choose the option that works best for you:- Self-Service Tools
- Talk to Our Team