Macha

How Do You Set Up SPF, DKIM and a Custom Mailbox in Freshdesk?

Abbas, Customer Support & AI, Macha

Written by

Ankeet Guha, Co-founder & CTO, Macha

Reviewed by

Published July 22, 2026

Updated September 24, 2026

Freshdesk replies land in spam when your domain hasn't authorized Freshdesk to send for it, and the fix is two DNS records: one SPF TXT record and four DKIM CNAMEs. Below are the exact values, the verification steps, and what changes when you send through your own Google Workspace or Microsoft 365 mailbox.

Key takeaways

  • Freshdesk email authentication starts with one SPF TXT record, v=spf1 include:email.freshdesk.com ~all, merged into any SPF record the domain already has.
  • Freshdesk generates four account-specific DKIM CNAME records under Admin, Channels, Email, Advanced Settings, Configure DKIM, and verification can take up to 48 hours.
  • Freshdesk DKIM only signs mail from a support address on a verified domain you own, so the default freshdesk.com address shows an empty DKIM settings page.
  • Freshworks lists DKIM on every Freshdesk tier; Growth, Pro and Enterprise add multiple support emails and custom email servers, while the Free program allows one support email.
  • With a Freshdesk custom mailbox on Google Workspace or Microsoft 365, the mail provider signs outbound mail, so SPF and DKIM are set up in that provider's console.
How Do You Set Up SPF, DKIM and a Custom Mailbox in Freshdesk?

To authenticate Freshdesk email, publish one SPF TXT record with v=spf1 include:email.freshdesk.com ~all (merged into any SPF record you already have), then add the four DKIM CNAME records Freshdesk generates under Admin → Channels → Email → Advanced Settings → Configure DKIM and click Verify. DKIM only works once you have a support email on a custom domain you own; if you route mail through your own Google Workspace or Microsoft 365 mailbox instead, your mail provider does the signing.

RecordTypeWhere it comes fromNeeded when
SPFTXT on your root domainv=spf1 include:email.freshdesk.com ~all (one per domain)Freshdesk sends your mail; Freshworks says it's optional if DKIM is set up
DKIM4 CNAME recordsGenerated per account on Freshdesk's Configure DKIM pageFreshdesk sends mail from a custom-domain support address
DMARCTXT at _dmarcYou write it; Freshdesk doesn't supply a valueRecommended once SPF and DKIM pass
Mail provider SPF/DKIMTXT / CNAMEGoogle Workspace or Microsoft 365 admin consoleYou use a custom mailbox (your server sends the mail)

What do SPF and DKIM actually do?

SPF (Sender Policy Framework) is a single DNS record that lists which mail servers are allowed to send email for your domain. When Freshdesk sends a reply from [email protected], the receiving server looks up your SPF record and checks whether Freshdesk's servers are on the approved list. DKIM (DomainKeys Identified Mail) goes a step further: it attaches a cryptographic signature to every outgoing message, and the receiving server validates that signature against a public key you've published in DNS. SPF answers "is this sender allowed?"; DKIM answers "was this message actually sent by them and untampered?".

You want both. Together they're what Gmail, Outlook and other mailbox providers use to decide whether your support mail is trustworthy, and they're the foundation a DMARC policy sits on later. Missing authentication is the most common reason a Freshdesk instance ends up in spam folders, so get it right before you touch anything fancier.

How do you publish the SPF record for Freshdesk?

SPF is the quicker of the two, and the value is the same for every Freshdesk account. Per Freshworks' Create an SPF record documentation, publish:

v=spf1 include:email.freshdesk.com ~all
  1. Log in to your DNS provider (the registrar or host that controls your domain: Cloudflare, GoDaddy, Route 53, and so on).
  2. Look for an existing SPF record. It's a TXT record on your root domain whose value starts with v=spf1. You can only have one SPF record per domain; a second one breaks both.
  3. If you have no SPF record yet, add a TXT record on your domain with the value above.
  4. If you already have one (for Google Workspace, Microsoft 365, a marketing tool), merge Freshdesk's include into it rather than adding a new record. For example: v=spf1 include:_spf.google.com include:email.freshdesk.com ~all.
  5. Save, and allow time for DNS to propagate.

SPF checks count against a hard limit of DNS lookups, so if your record is getting crowded you can swap the generic include for a data-center-specific one: fdspfus.freshemail.io (US), fdspfeuc.freshemail.io (EU), fdspfind.freshemail.io (India), or fdspfaus.freshemail.io (Australia), matching wherever your Freshdesk account is hosted. Freshworks' own doc also says SPF configuration isn't required if you already have DKIM set up. Publishing both is still the safer default, because some receivers weigh SPF alignment on its own.

How do you set up DKIM in Freshdesk?

DKIM is where deliverability really lives, and it's also where the setup gets conditional. In Freshdesk, DKIM is configured under Admin → Channels → Email → Advanced Settings → Configure DKIM, as documented in Freshworks' Email domain verification using DKIM records guide.

The catch, and the reason the screenshot below looks the way it does: DKIM applies to a support email on a custom domain that you own ([email protected]), not to the default @yourcompany.freshdesk.com address you get out of the box. If you haven't added and verified a support email on your own domain yet, Freshdesk has nothing to sign, so the DKIM Settings page shows an empty state prompting you to create one first.

Once you do have a custom support domain, the flow is:

  1. Open Admin → Channels → Email → Advanced Settings → Configure DKIM and expand your domain.
  2. Freshdesk generates four CNAME records unique to your account. Copy each one exactly: the host/name on the left and the target it points to on the right.
  3. Add all four CNAME records at your DNS provider, matching Freshdesk's values precisely (a single wrong character fails the check).
  4. Return to the same DKIM page and click Verify.
  5. Freshdesk checks your DNS and shows a green check next to each record it can validate, or a red cross where the record isn't found yet.
Freshdesk's DKIM Settings page in its empty state: 'You haven't created a support email with a custom domain yet'
Freshdesk's DKIM Settings page in its empty state: 'You haven't created a support email with a custom domain yet'

DNS changes aren't instant. Freshworks notes propagation can take anywhere from a few minutes to several hours, and in some cases up to 48 hours, so if Verify shows red crosses right after you publish the records, wait and try again before assuming you got the values wrong. You'll get an email confirmation once verification completes.

Which Freshdesk plans include DKIM?

Freshworks' DKIM doc lists it on every tier, current and legacy, so DKIM itself isn't a paid upgrade. The pricing page today sells three plans (Growth, Pro and Enterprise) and no free plan; the old Free tier now survives as a Free program for up to 2 agents for 6 months. What varies is how many support addresses you can add. Growth, Pro and Enterprise allow multiple support emails and custom email servers, while the Free program allows one support email. Either way, the practical gate is the same: DKIM needs a verified support address on your own domain before there's anything to sign.

What changes when you use a custom mailbox?

A custom mailbox (Freshworks calls it a custom email server) is when you route Freshdesk through your own mail infrastructure, connecting a Gmail/Google Workspace, Microsoft 365 or other IMAP/SMTP mailbox so mail is sent from your servers rather than Freshdesk's. Freshworks lists custom email servers on the Growth, Pro and Enterprise plans. This changes the authentication picture.

Because the mail leaves your infrastructure, Freshdesk's DKIM signing isn't doing the work; your own mail provider's authentication is. Freshworks says DKIM verification is not specifically required for a custom email server in Freshdesk, but still recommends configuring DKIM for your own DNS. In practice: set up SPF and DKIM for your mailbox with your mail provider (Google Workspace and Microsoft 365 both publish their own steps), make sure your SPF record authorizes that sending infrastructure, and treat Freshdesk's DKIM page as an optional extra rather than the primary control.

The decision comes down to who sends the mail:

Freshdesk sends the mailCustom mailbox (you send the mail)
Who signs the messageFreshdesk (DKIM via its 4 CNAMEs)Your mail provider (Google / Microsoft)
Where you set DKIM upFreshdesk Admin → Configure DKIMYour mail provider's admin console
SPF include to addemail.freshdesk.comYour provider's (e.g. _spf.google.com)
Custom domain required for DKIMYesHandled by your provider
Freshdesk DKIM pagePrimary controlOptional / recommended extra

Where does Freshdesk's native email authentication stop?

Freshdesk's built-in SPF and DKIM tooling does the job: the SPF value is a copy-paste, the DKIM page generates account-specific records and verifies them with clear green-check/red-cross feedback, and DKIM costs nothing extra. For most teams it's all you need to escape the spam folder.

Know the edges, though. The custom-domain requirement is the real gate: DKIM only signs mail from a support address on a verified domain you own. If you're still replying from the default @yourcompany.freshdesk.com address, you can't sign outbound mail through Freshdesk, and the DKIM page keeps showing that empty state. Freshdesk also doesn't provide a DMARC value (the policy layer that tells receivers what to do when SPF or DKIM fail), so you write that record yourself, usually starting at p=none to collect reports before tightening. And once your DNS is clean, deliverability stops being the bottleneck: authentication decides whether your reply is delivered, not how good or how fast it is. For the surrounding options, Freshdesk email explained covers them.

That second problem, the quality and speed of the reply itself, is where an AI agent layer fits, sitting on top of the deliverability you've just fixed. The broad category of AI agents for customer service exists to do the reading and writing that DNS records can't. Macha is one such layer: it connects to the Freshdesk you already use as a native connector and doesn't replace your help desk, your mailbox, or your DNS setup. You connect it with your subdomain and API key, and it reads and writes the same tickets, drafting or posting grounded replies and looking up order or account status through a custom tool that turns a REST API into something the agent can call. The longer version is in how to automate Freshdesk with AI. (Macha's connector is for Freshdesk specifically, not Freshchat, Freshservice, or Freshcaller. Billing is per ticket, one conversation charged once however many messages it takes, never per resolution; the pricing page has the tiers.)

The division of labor: let SPF and DKIM make sure the message arrives, and put an agent on top so the message that arrives is a fast, correct answer.

FAQ

What SPF record does Freshdesk need? Publish a single TXT record on your domain with the value v=spf1 include:email.freshdesk.com ~all. If you already have an SPF record for Google Workspace, Microsoft 365 or another tool, merge Freshdesk's include into that record rather than creating a second one; a domain can only have one valid SPF record.

Why does the DKIM page say I haven't created a custom domain? Because DKIM in Freshdesk signs mail sent from a support email on a verified custom domain you own ([email protected]), not the default @yourcompany.freshdesk.com address. Until you've added and verified a support address on your own domain, there's nothing for Freshdesk to sign, so the DKIM Settings page shows an empty state prompting you to create one first.

How long do DKIM records take to verify? DNS propagation can take anywhere from a few minutes to several hours, and in some cases up to 48 hours. If Freshdesk shows red crosses right after you publish the four CNAME records, wait and click Verify again before assuming the values are wrong.

Is DKIM limited to higher Freshdesk plans? No. Freshworks lists DKIM on every tier, including legacy plans. The limits are on support addresses: Growth, Pro and Enterprise allow multiple support emails and custom email servers, and the Free program (up to 2 agents for 6 months) allows one.

Do I still need DKIM if I use a custom mailbox? Freshdesk says DKIM verification isn't strictly required for a custom email server, because your own mail provider handles the signing, but Freshworks still recommends configuring SPF and DKIM at your provider's end (Google Workspace or Microsoft 365) so outbound mail is authenticated from your own infrastructure.

Does fixing SPF and DKIM improve my reply quality? No. Authentication only controls whether your mail reaches the inbox instead of spam. To improve the speed and quality of the reply itself, you'd layer an AI agent like Macha on top of Freshdesk, which drafts or sends grounded replies while Freshdesk and your DNS stay exactly as they are.

Once your mail is landing in the inbox, the next win is making the reply itself faster and better. Start a free trial of Macha and connect it to your Freshdesk in minutes.

Macha

About Macha

Macha is an AI agent platform that works on top of the help desk you already use (Zendesk, Freshdesk, Gorgias, Front, Intercom or HubSpot) and connects to the rest of your stack, even your own internal systems. It is done for you: the Macha team analyzes your past tickets, builds the knowledge base and the agents, and runs them in safe mode until the drafts are right. Pricing is about $0.40 a ticket, and that includes setup and a dedicated success manager who handles your changes. Learn more about Macha →

Zendesk
5.0 on Zendesk Marketplace

Loved by support teams worldwide

See what support teams are saying about Macha AI.

The application seems excellent to me! We are still testing, and we need support for some details and they were extremely efficient too!

Daniela Costa

Daniela Costa

Head of Support, Seabra

Macha has been a great addition to our support toolkit. It generates clear, well-organized responses that fit naturally into our workflow. One feature we particularly appreciate is its ability to automatically reply in the same language as the ticket.

Marius F

Marius F

Support Head, Zentana

We've been using Macha for a little while now and it's been really great addition so far! It's powerful, convenient, and makes getting work done a lot easier for our agents.

Alexander Wedén

Alexander Wedén

Head of Support

Support team is very helpful and responsive. Really enjoy how lightweight this is within Zendesk itself vs other more intrusive tools.

Cathleen Wright

Cathleen Wright

Zendesk Admin, Cortex IO

So far it's pretty good! Our queries are a little nuanced, so we can't always use it, but it's got enough utility for us. It can even incorporate our bilingual country with greetings in a second language.

Jae Oliver

Jae Oliver

Head of Support, Wise

Really enjoying using Macha, it has made a noticeable difference to our support team in a short amount of time. I really like the ticket summary feature, saves us a lot of time.

Harry Jackson

Harry Jackson

Head of Support, Crumb

Macha AI is a great addition to my workspace! It's powerful, convenient, and it really makes productivity so much easier for our agents!

Dave G

Dave G

Head of Support, Cyber Power Systems

Very impressed! AI integration for Zendesk has certainly come a long way and Macha seems to set the standard for now. This will for sure save lot of time in our support team.

Pauli Juel

Pauli Juel

Head of CS, Dokument24

Macha has been working great for us so far! The auto-responses are accurate and our resolution time has dropped significantly.

Lana T

Lana T

Zendesk Admin, Swotzy

Macha AI is a great addition. The knowledge base feature means our agents always have the right answers at their fingertips.

Mischa Wolf

Mischa Wolf

Head of Support, Topi

We're enjoying this integration so far. It's made our support team more efficient and our customers get faster responses.

Paula G

Paula G

Head of Customer Support, Xly Studio

The team enjoys using it. It saves considerable time on common questions and the integration options are excellent.

Kilian Leister

Kilian Leister

Support Head, Didriksons

Get your AI agents set up for you.

Book a 20-minute call with our team. We'll show you where we would start on your Freshdesk and how the setup works. Setup and a dedicated success manager come with the trial and every plan.

Live in under a week
Safe mode until you approve
About $0.40 a ticket