Charchy Senddocs

Troubleshooting

The common problems and their fixes — a domain that won't verify, domain_not_verified, emails delivered but not received, and keys used from the browser.

My domain won't verify

Domains in the dashboard shows each record's status and keeps checking.

  • Wait. New records usually appear within minutes; some DNS providers take an hour or more.
  • The domain written twice. Many DNS panels append your domain to every name, so a pasted full name lands at abc123._domainkey.yourdomain.com.yourdomain.com. Enter only abc123._domainkey. Your provider's page shows how: Cloudflare · Hostinger · GoDaddy · Namecheap · Route 53.
  • The Cloudflare proxy is on. DKIM records must be DNS only (grey cloud), never Proxied.
  • You edited the wrong place. Records only count where your domain's nameservers point — if DNS is hosted somewhere other than your registrar (Cloudflare, your web host), add them there. dig NS yourdomain.com shows where.
  • A typo in the value. Use the copy button; one missing character breaks the record.

Check a record yourself:

dig CNAME abc123._domainkey.yourdomain.com +short
dig TXT _dmarc.yourdomain.com +short

The API says domain_not_verified or sender_not_allowed

  • domain_not_verified: the domain is in this workspace but not verified. Finish its records in Domains (see above). If verification gave up after 72 hours, or a verified domain lost its records, you also got a domain.failed webhook.
  • sender_not_allowed: the from domain isn't in this workspace. Check for a typo, and that you're using this workspace's key.
  • Sending from a subdomain (mail.yourdomain.com)? The subdomain itself must be the verified domain.
  • Worked before, now emails end failed with reason domain_not_verified? Someone changed the DNS — put the records back; the domain comes back by itself within hours. Those emails are refunded.
  • Just testing? A test key may send from any domain.

Delivered, but it never arrived

delivered means the recipient's mail server accepted the email; what happens next is that provider's choice.

  • Look in spam and promotions. If it's there, your domain is new or unauthenticated: set up DMARC and warm up.
  • Company mail servers sometimes quarantine mail from new senders. Ask the recipient's IT team to check.
  • Gmail cut the email off. Gmail clips emails over about 102 KB behind a "[Message clipped]" link. Keep the HTML small and use hosted images.
  • Gmail joined two emails into one thread. Two sign-in codes with the same subject can collapse into one conversation. Put the code in the subject, or add a unique X-Entity-Ref-ID header.
  • Still nothing? Open the email in Emails and send its id to support@charchy.krd — we can see the receiving server's answer.

It says suppressed

The address hard-bounced or complained before, so we skipped it and didn't charge. Suppressions explains when you can let a bounced address back.

It says unknown

The email was handed over, but no answer or delivery event came back within 30 minutes. It may have left, so we never send it again, and the charge stays. A later event can still settle it; if it stays unknown, send its id to support@charchy.krd.

"CORS" errors, or a key used from the browser

The API sends no CORS headers, so a fetch from a web page fails — on purpose: a key in browser code is a key anyone can copy.

Move the call to your server (an API route, a server action, your backend), reading the key from its environment. If the key has already shipped in browser code, revoke it.

401 invalid_api_key in production only

  • The production environment doesn't have CHARCHY_SEND_KEY set, or still has an old value after a key was revoked.
  • The value is cut off or has extra characters: a key is chy_live_ or chy_test_ followed by 64 characters.
  • Your host needs a redeploy before new environment variables apply.

403 not_approved

Before approval, a live key sends only to your own team, up to 50 recipients a day. Use magic addresses or a test key meanwhile, and write to support@charchy.krd to finish approval.

On this page