support@yourdomain.com. You find it in the AI agent’s Settings, on the Email tab, and it’s used together with the Email channel (available on paid plans). Each AI agent gets a unique agent email in the format agent@subdomain.chatbase-mail.com that you can:
- Send emails and automatically receive AI-crafted replies.
- Connect to your own domains and mailboxes, so customers see messages coming from your email addresses instead of the default
chatbase-mail.comdomain.
How it works
- Agent email: When you enable email for an AI agent, Chatbase generates an address like
agent@subdomain.chatbase-mail.com. The subdomain is a random string created once: it isn’t based on the AI agent’s name, doesn’t change if you rename the AI agent, and can’t be customized. - Inbound messages: Customers send an email to:
- Your agent email, or
- One of your own addresses (for example,
support@yourdomain.com) that automatically forwards to the agent email.
- AI response: Your AI agent processes the email and generates a reply.
- From address:
- If you don’t connect a domain, replies are sent from your
agent@subdomain.chatbase-mail.com. - If you do connect and authenticate a domain, we can send email on your behalf (for example,
support@yourdomain.com), once DNS is correctly configured. - With several verified addresses, the AI agent can reply from the same address the customer emailed. See Reply addresses.
- If you don’t connect a domain, replies are sent from your
Prerequisites
- Access to the Chatbase dashboard and the AI agent whose email settings you want to configure.
- Admin access to your email provider to set up forwarding rules.
- Admin access to your DNS provider (domain registrar or DNS host) to add two CNAME records and one TXT record. You don’t need to change your MX records.
- An address on a company domain. Addresses on free email providers are rejected with “Please use a valid business email address”.
Accessing Email settings
Open your AI agent settings

Locate your agent email
agent@subdomain.chatbase-mail.com
Using the agent email directly
You can start using the feature immediately by sending an email to your agent email:- Send an email from any mailbox to
agent@subdomain.chatbase-mail.com. - The AI agent processes the email content.
- You receive a reply from the same
agent@subdomain.chatbase-mail.comaddress.
support@yourdomain.com or billing@yourdomain.com), continue with the next sections.
Step 1 – Add an email address
To configure a custom email address for your AI agent, start by adding the email address you want to use.Click New email

Enter your email address
support@yourdomain.com).
Continue to forwarding setup
Step 2 – Configure email forwarding
Next, configure automatic forwarding in your email provider so that emails sent to your support addresses are delivered to your agent email.Forwarding flow
- A customer emails
support@yourdomain.com. - Your email provider forwards that message automatically to
agent@subdomain.chatbase-mail.com. - The AI agent processes the email and generates a reply.
- The response is sent back via email from your authenticated domain.
Set up forwarding in your email provider
The exact steps depend on your provider, but the general pattern is:- Sign in to your email provider’s admin or mailbox settings.
- Open the Forwarding, Rules, or Filters section.
- Create a rule that forwards incoming messages from the mailbox (for example,
support@yourdomain.com) to your agent email (agent@subdomain.chatbase-mail.com). - If your email provider requires verification before allowing the forwarding rule:
- The provider will send a verification email to your agent email.
- You can find and approve the verification email in your AI agent’s Activity > Conversations.
- Click Verify automatic forwarding in the Email settings drawer.
- If everything is set up correctly, you’ll be taken to the authenticate domain step (Step 3).
Provider-specific forwarding guides
For detailed instructions on setting up email forwarding, refer to your email provider’s documentation. Here are links to official guides for popular email providers:Google Workspace and Gmail
Configure email forwarding in Google Workspace (Admin Console), recommended
Open the Google Workspace Admin Console
Go to Gmail routing settings
Create a routing rule for your support address
-
Set Envelope Recipient to the email address you want customers to use (for example,
support@yourdomain.com). - Under Envelope Recipient, select Change Envelope Recipient.
-
In Replace Recipient, enter your Chatbase agent email (for example,
agent@subdomain.chatbase-mail.com).

Save the rule and enable it for recognized + unrecognized addresses

Verify forwarding in Chatbase
Forward from a personal Gmail inbox
- Gmail (personal inbox forwarding): Set up email forwarding in Gmail
Prevent forwarded emails from going to spam
Gmail doesn’t forward emails that it marks as spam, so some customer emails may never reach your AI agent. To make sure every email is forwarded, create a filter that stops Gmail from sending incoming emails to spam.Open Gmail filter settings
Create a filter that matches all emails
200 MB.This matches every incoming email. Then click Create filter.Never send matching emails to spam
Microsoft
- Outlook (all versions): Turn on automatic forwarding in Outlook. Follow this guide to set up forwarding to your Chatbase agent email. This works for Outlook.com, New Outlook, Classic Outlook, and Outlook on the web.
Allow external forwarding in Microsoft 365 (required for work accounts)
After setting up forwarding in Outlook, Microsoft 365 will block the forwarded emails from leaving your organization by default. Your Microsoft 365 administrator must allow external forwarding for the emails to reach Chatbase. Without this step, forwarding appears configured in Outlook but emails are silently blocked and Chatbase verification will fail. For more details, see Microsoft’s documentation on external email forwarding.Allow external forwarding in the outbound spam policy
Verify forwarding in Chatbase
Other email providers
- Yahoo Mail: Automatically forward emails in Yahoo Mail
- ProtonMail: Set up email forwarding in ProtonMail
Step 3 – Authenticate your domain with DNS
Once we detect automatic forwarding from at least one email address on the domain, you’ll be able to proceed to DNS authentication. This step allows Chatbase to send emails on your behalf from your custom domain.View your DNS records
After forwarding is verified, you’ll see the DNS records you need to add. In the Email settings drawer, you’ll see:- Record type (CNAME or TXT)
- Name (the DNS record name)
- Value (the DNS record value)

Add records at your DNS provider
Sign in to the DNS provider that manages your domain (this might be your registrar or a DNS host like Cloudflare), then add the records we provided.- CNAME record for DKIM authentication (e.g.,
chatbase._domainkey) - CNAME record for SPF authentication (e.g.,
outbound.chatbase) - TXT record for DMARC policy (e.g.,
_dmarc)
Provider-specific DNS guides
For detailed instructions on DNS authentication, here are links to official guides for popular DNS and domain providers:Domain registrars
- GoDaddy: Add a TXT or CNAME record
- Namecheap: How to manage DNS records
DNS hosting providers
- Cloudflare: Manage DNS records
- Amazon Route 53: Working with DNS records
- Google Cloud DNS: Managing DNS records
- Azure DNS: Manage DNS records
Verify your domain
After you add the DNS records at your DNS provider:- Return to the Email settings drawer in Chatbase.
- Click Validate to check if the DNS records are correctly configured.
- DKIM: Shows as “authenticated” when the CNAME record is found
- SPF: Shows as “authenticated” when the CNAME record is found
- DMARC: Shows as “authenticated” when the TXT record is found
support@yourdomain.com) instead of the default agent@subdomain.chatbase-mail.com address. Learn more about configuring the email channel.Adding and managing email addresses
After you’ve added your first email address and completed the setup process, you can add additional email addresses to the same domain or add emails from different domains.Adding more email addresses
To add additional email addresses:- Click New email in the Email configuration card on the Email tab.
- Enter the new email address (for example,
sales@yourdomain.com). - Follow the same 3-step process:
- Enter the email address
- Configure email forwarding
- Authenticate the domain (if not already done)
Managing existing email addresses
The Email configuration card lists every address you have added, grouped by domain:- Each domain heading shows its authentication status. authenticated means the DKIM, SPF, and DMARC records from Step 3 above have all been verified.
- The Automatic forwarding column shows whether forwarding from that address to your agent email has been verified.
- Click the pencil icon on a row to reopen that address’s setup steps, for example to re-verify forwarding or check the DNS records.
- Click the trash icon to remove the address. Removing the last address on a domain removes the domain too, so you can reuse the slot.
Testing your setup
Once forwarding and DNS are configured:- Send an email from an external address (for example, your personal Gmail) to one of your connected addresses (for example,
support@yourdomain.com). - Confirm that:
- The conversation appears under your AI agent’s conversations.
- The reply is sent back to your external address.
- The From address matches your expectations:
- If the domain is not verified: it will come from
agent@subdomain.chatbase-mail.com. - If the domain is verified: it will come from your configured address on that domain.
- If the domain is not verified: it will come from
Troubleshooting
Email forwarding issues
I don’t see emails in my AI agent conversations- Confirm that forwarding is enabled and points to the correct agent email (
agent@subdomain.chatbase-mail.com). - Check for filters or rules that might be archiving or deleting messages before they are forwarded.
- Verify that your email provider has sent and you’ve approved any required verification emails.
- Check your agent email’s conversation history for any verification emails that need approval.
- If you forward from Gmail, check your Spam folder. Gmail doesn’t forward emails marked as spam. See Prevent forwarded emails from going to spam.
DNS authentication issues
Domain verification fails- Ensure there are no typos in the CNAME or TXT record values. Copy them exactly as shown.
- Verify that you added records on the correct DNS zone:
- For
yourdomain.com, add records at the root level - For
subdomain.yourdomain.com, add records for the subdomain
- For
- Wait for DNS propagation. Some providers can take up to 48 hours to update DNS records globally.
- Each record is verified independently. Check each one:
- DKIM (CNAME): Verify the name includes
chatbase._domainkey - SPF (CNAME): Verify the name includes
outbound.chatbase - DMARC (TXT): Verify the name includes
_dmarc
- DKIM (CNAME): Verify the name includes
- Ensure the record values match exactly what’s shown in Email settings.
Microsoft 365 forwarding blocked
Verification keeps failing and no emails reach Chatbase- Microsoft 365 blocks automatic external forwarding by default. Your admin must enable it in the outbound spam filter policy. See Allow external forwarding in Microsoft 365 above.
- Check if the sender is receiving a non-delivery report (NDR) with the error:
5.7.520 Access denied, Your organization does not allow external forwarding. This confirms external forwarding is blocked. - If using a custom outbound spam policy, ensure the policy applies to the correct users or groups.
General issues
I can’t add more domains- Each AI agent can have up to 3 domains. Adding a fourth shows “You can add up to 3 domains. Please remove an existing domain before adding a new one.” Remove an existing domain from this AI agent if you need to add a new one.
- You can add up to 20 email addresses per domain (“You can add up to 20 email addresses per domain.”). Consider using a different domain if you need more addresses.
- Addresses on free email providers can’t be added, and show “Please use a valid business email address”. Use an address on your company’s domain.
- Ensure all DNS records (DKIM, SPF, DMARC) are properly configured and verified.
- Check your domain’s reputation using tools like MXToolbox.
Limits
Frequently asked questions
Is the 3-domain limit per AI agent or per workspace?
Is the 3-domain limit per AI agent or per workspace?
Do I need to add an MX record?
Do I need to add an MX record?
outbound.chatbase) and a DMARC TXT record. Incoming mail reaches the AI agent through forwarding, so your MX records stay as they are.Is DMARC required?
Is DMARC required?
Does the agent email change if I rename my AI agent?
Does the agent email change if I rename my AI agent?
agent@subdomain.chatbase-mail.com address uses a random subdomain created when email is enabled. Renaming the AI agent doesn’t change it, and it can’t be customized. To have customers see your own address, connect your domain.Can I use a Gmail or Outlook.com address?
Can I use a Gmail or Outlook.com address?
Can two AI agents use the same domain?
Can two AI agents use the same domain?