Configure email domains
Configure custom sending domains, add required DNS records, verify status, and generate SMTP credentials for outgoing email.
Email domain settings overview
Configure custom sending domains so Emailit can send email from addresses on your own domain (for example, support@acme.co) instead of a shared default domain.
The Email page in Settings is organized into two main areas:
Use this tab to add new sending domains, view required DNS records, and track verification status.
Use this tab to generate SMTP credentials for verified domains so external systems can send mail through Emailit.
Prerequisites
To configure a custom email domain, you need:
- Access to the Email settings page as a tenant admin or equivalent role.
- Admin access to your domain registrar or DNS provider (for example, Cloudflare, Route 53, GoDaddy).
- Permission to add or edit DNS records (TXT and CNAME) for your domain.
DNS changes can take time to propagate. Verification may complete in as little as 15 minutes, but it can take up to 48 hours depending on your DNS provider.
Domains and DNS verification
The Email Domain Settings section lets you register domains, view DNS instructions, and monitor verification.
Key fields and controls
The sending domain you want to configure, for example acme.co. Enter the bare domain without protocol or path.
List of DNS records that you must add at your DNS provider to verify the domain. Each record includes type (TXT or CNAME), name/host, value, and (for some TXT records) priority.
The current verification status for the domain. Values: Pending, Verified, or Failed.
Button that triggers an immediate re-check of DNS records for the domain.
Toggle that automatically refreshes verification status for pending domains approximately every 5 minutes.
Action that removes the domain and its verification data after a confirmation step.
When you delete a verified domain, Emailit stops sending email using that domain. Update any workflows or SMTP integrations before removing domains that are in active use.
Domain status values
Domain cards show a status badge:
- Pending — You added the domain, but required DNS records are not fully detected yet. This is the expected state right after adding records at your DNS provider.
- Verified — All required DNS records are present and valid. Emailit can send from this domain and expose SMTP credentials.
- Failed — DNS records are missing, incorrect, or conflicting. You need to fix DNS at your provider and then run Check status again.
If a domain keeps bouncing between Pending and Failed, review the DNS records carefully for typos, extra spaces, or conflicting entries.
Add and verify a sending domain
Use these steps to register a new domain and complete DNS verification.
Open Email settings
Go to Settings → Email in the sidebar, then look in the Email Domain Settings section.
You should see an input labeled for adding a new domain and an Add button.
Add your domain
Enter the domain you want to use for sending, such as acme.co.
Avoid including subdomains like mail.acme.co unless you specifically intend to configure a subdomain as the sending domain.
Click Add.
A new domain card appears with a Pending status and a list of required DNS records.
Review required DNS records
On the new domain card:
- Review each DNS record in the DNS records section.
- Note the Type (
TXTorCNAME), Name/Host, Value, and any Priority. - Use the copy buttons next to Name and Value fields to avoid typos when configuring DNS.
Typical records help prove ownership of your domain and authorize Emailit as a sender (for example, SPF and DKIM-related records).
Add records at your DNS provider
In a separate tab, open your DNS provider or domain registrar and add the records from the domain card:
- Create TXT records with the exact Name and Value shown.
- Create CNAME records matching the Name and Value, leaving other defaults as suggested by your provider.
- If your provider automatically appends the domain, enter only the host part shown in the Name field (for example,
emailinstead ofemail.acme.co).
After saving all records, return to the Email settings page.
Wait for DNS propagation
Keep the domain card open and watch the status:
- Leave Auto-refresh enabled so Emailit re-checks DNS every few minutes.
- If you prefer manual control, disable auto-refresh and use Check status when you are ready.
DNS propagation often completes within 15–30 minutes, but it can take up to 48 hours.
Confirm domain is verified
Once all records are visible and valid:
- The domain status badge changes to
Verified. - The DNS records section shows each record as successful.
- The SMTP credentials section for this domain becomes available.
At this point, Emailit can send email using this domain through configured workflows and integrations.
Manage SMTP credentials
After verification, use SMTP credentials to send email through Emailit from external systems such as CRMs, ticketing tools, or custom applications.
SMTP credentials for a verified domain
For each Verified domain, the domain card shows an SMTP Credentials section listing existing credentials and a Create button.
Identifier used when authenticating over SMTP. Each credential has a unique username.
Timestamp when the SMTP credential was created, displayed for auditing.
Indicator that the credential is currently active and can be used for sending.
Create SMTP credentials
Use these steps when you need a new SMTP login for a verified domain.
Open the verified domain
Go to Settings → Email and locate the domain card with a Verified status.
Scroll to the SMTP Credentials section on that card.
You should see a list of existing credentials (if any) and a Create button.
Create a new credential
Click Create in the SMTP Credentials section.
Wait for the interface to generate a new SMTP credential entry.
A new row appears with a generated username, creation date, and an active status indicator.
Use credentials in your SMTP client
Configure your SMTP client or integration using:
- The SMTP hostname and port documented for Emailit in your integration or environment settings.
- The generated username from the credentials list.
- The corresponding password or secret presented when the credential is created (store this securely according to your security policies).
Send a test email from your client using a From address on the verified domain to confirm everything is working.
Delete a domain
Only remove a domain when you are sure it is no longer used for sending.
Confirm impact
Before deleting:
- Check workflows, automations, or SMTP integrations that send from this domain.
- If needed, migrate them to another verified domain first.
Once deleted, Emailit cannot send email using that domain until you add and verify it again.
Delete the domain
Go to Settings → Email and find the domain card you want to remove.
Click the Delete action on that card, then confirm the deletion in the dialog.
The domain and its DNS verification data are removed from Email settings.
Troubleshooting domain verification
Use this section if your domain stays Pending or becomes Failed.
If the domain has been Pending for more than a few hours:
- Use Check status to trigger a fresh DNS lookup.
- Verify that the DNS records exist at your provider and have fully propagated.
- Check whether your provider uses separate fields for host vs. domain; some providers automatically append the domain name.
If the domain remains Pending after 48 hours, compare DNS values carefully against the Email settings page and fix any mismatches.
Last updated today
Built with Documentation.AI