sendgrid expected cname for to match

SendGrid Expected CNAME to match means a domain-auth CNAME is missing or wrong. Publish the exact records, use a relative host name, and disable proxy.

Updated Jul 1, 2026

The short answer

"Expected CNAME for X to match Y" is a SendGrid domain-authentication validation error: a CNAME record SendGrid told you to publish either doesn't resolve or points somewhere other than the expected sendgrid.net target. Fix it by publishing the exact host and target SendGrid generated, entering the host as a relative name (so it isn't duplicated as domain.com.domain.com), unproxying the record, and waiting for DNS propagation before re-validating.

SendGrid returns "Expected CNAME for em1234.example.com to match u1234567.wl123.sendgrid.net" when you click Verify on a Domain Authentication (formerly "domain whitelabel") setup and the CNAME it queries either does not resolve or resolves to a value other than the target it generated for you. It is a DNS-side error, not an SMTP send error — your domain is simply not authenticated yet.

What causes "Expected CNAME for X to match Y"?

SendGrid's automated-security setup signs your DKIM and aligns your SPF using CNAME records that delegate to SendGrid-hosted DNS. When you save a domain, SendGrid generates records like these (per the SendGrid domain authentication docs):

HOST TYPE POINTS TO
em1234.example.com CNAME u1234567.wl123.sendgrid.net
s1._domainkey.example.com CNAME s1.domainkey.u1234567.wl123.sendgrid.net
s2._domainkey.example.com CNAME s2.domainkey.u1234567.wl123.sendgrid.net

The validator does a live DNS lookup of the host on the left and checks that it is a CNAME pointing at the value on the right. The error fires when, per SendGrid's Troubleshooting Sender Authentication guide, one of these is true:

  • The host is duplicated. Many DNS panels (GoDaddy, etc.) auto-append your domain, so entering em1234.example.com becomes em1234.example.com.example.com. The host SendGrid queries then doesn't exist.
  • The target is wrong or truncated. A typo, an extra trailing dot, or the panel rewriting sendgrid.net value breaks the match.
  • The record is proxied. A CNAME behind Cloudflare's orange-cloud proxy resolves to Cloudflare IPs (effectively an A record), not the sendgrid.net CNAME, so the match fails.
  • A conflicting record exists. An existing MX, A, or TXT record on the same host blocks the CNAME (a host can have only one CNAME and no other record per RFC 1034 §3.6.2).
  • DNS hasn't propagated yet. Changes can take up to 48 hours.
  • Duplicate domain entries. Stale Pending/Failed authentication entries for the same domain in SendGrid confuse validation.

How do I fix "Expected CNAME for X to match Y"?

  1. Copy the exact host and target from SendGrid. Settings → Sender Authentication → your domain → View DNS Records. Don't retype them.
  2. Enter the host as a relative name if your DNS panel appends the domain. Use em1234, not em1234.example.com. SendGrid's GoDaddy guide gives the corrected form:

  3. em1234 — Points to: u1234567.wl123.sendgrid.net
  4. s1._domainkey — Points to: s1.domainkey.u1234567.wl123.sendgrid.net
  5. s2._domainkey — Points to: s2.domainkey.u1234567.wl123.sendgrid.net
  1. Verify with dig before re-validating. The output must show the exact sendgrid.net target:

    dig +short CNAME em1234.example.com
    # expected: u1234567.wl123.sendgrid.net.
  2. Turn off proxying (Cloudflare: set the record to "DNS only" / grey cloud).
  3. Remove conflicting records on the same host, and delete any Pending/Failed duplicate domain authentication entries in SendGrid.
  4. Wait for propagation (up to 48 hours) and click Verify again. If dig returns the correct value but SendGrid still fails, contact SendGrid Support.

Note: this CNAME error is distinct from a lookup ... no such host failure on a _domainkey TXT record, which happens when manual DKIM is used and the key was split across multiple quoted strings — that is a different setup path and not what "Expected CNAME to match" refers to.

References

Authoritative sources

DOCS

SendGrid Docs — Troubleshooting Sender Authentication

DOCS

SendGrid Docs — Configure Domain Authentication

HELP

SendGrid Support — Configuring and Troubleshooting CNAME Records on GoDaddy Domains

RFC

RFC 1034 — Domain Names: Concepts and Facilities (CNAME restrictions)

FAQ

Common questions

Your DNS panel most likely appended your domain to the host, creating em1234.example.com.example.com. SendGrid then queries em1234.example.com, finds nothing, and reports the host doesn't resolve. Re-enter the host as the relative name (em1234) so the panel produces the correct FQDN.

Yes. A proxied (orange-cloud) CNAME resolves to Cloudflare's edge IPs instead of the sendgrid.net target, so SendGrid can't match it. Set the record to DNS only (grey cloud) and re-validate.

DNS changes can take up to 48 hours to propagate. If dig already returns the exact sendgrid.net target but SendGrid still fails verification, the records are correct — contact SendGrid Support to investigate.

Keep going

Related SendGrid errors

View all errors →

One API, every provider

Stop debugging raw provider errors

Courier connects to your email, SMS, and push providers, handles retries and failover, and surfaces delivery errors in plain language.

Start building freeRead the docs

Reply-code definitions per RFC 1034 §3.6.2. Last reviewed Jul 1, 2026. Courier is not affiliated with third-party providers; error behavior may vary by implementation.

Multichannel Notifications Platform for SaaS

Products

Platform

Integrations

Customers

Blog

API Status

Subprocessors

© 2026 Courier. All rights reserved.