Skip to main content

Overview

Using a custom domain allows your AI agents to send emails from addresses like [email protected] instead of a generic address. This improves deliverability, builds trust with recipients, and maintains your brand identity.

Prerequisites

Before you begin, ensure you have:
  • Access to your domain’s DNS settings
  • A verified Jasni account
  • Administrative access to your Jasni workspace

Step 1: Add Your Domain

Navigate to your Jasni Dashboard and add your domain:
  1. Go to Settings > Domains
  2. Click Add Domain
  3. Enter your domain name (e.g., yourdomain.com)
  4. Click Continue
You can add multiple domains to a single Jasni account.

Step 2: Configure DNS Records

After adding your domain, you’ll need to configure several DNS records for authentication and deliverability.

SPF Record

SPF (Sender Policy Framework) authorizes Jasni to send emails on behalf of your domain.
TypeHostValue
TXT@v=spf1 include:_spf.jasni.ai ~all
If you already have an SPF record, add include:_spf.jasni.ai to your existing record instead of creating a new one. Multiple SPF records can cause delivery issues.

DKIM Records

DKIM (DomainKeys Identified Mail) adds a digital signature to verify your emails haven’t been tampered with.
TypeHostValue
CNAMEjasni1._domainkeyjasni1._domainkey.jasni.ai
CNAMEjasni2._domainkeyjasni2._domainkey.jasni.ai

DMARC Record

DMARC (Domain-based Message Authentication, Reporting & Conformance) tells receiving servers how to handle emails that fail authentication.
TypeHostValue
TXT_dmarcv=DMARC1; p=quarantine; rua=mailto:[email protected]
Start with p=none during setup, then move to p=quarantine or p=reject once you’ve confirmed everything works correctly.

MX Records (for receiving)

If you want to receive emails through Jasni, add these MX records:
TypeHostPriorityValue
MX@10mx1.jasni.ai
MX@20mx2.jasni.ai

Step 3: Verify Your Domain

Once your DNS records are configured:
  1. Return to Settings > Domains in your dashboard
  2. Click on your domain
  3. Click Verify DNS
DNS propagation can take up to 48 hours, though it typically completes within a few hours. You can check propagation status using tools like whatsmydns.net.

Verification Status

StatusDescription
PendingDNS records not yet detected
PartialSome records verified, others pending
VerifiedAll records verified, domain ready to use
FailedIncorrect DNS configuration detected

Step 4: Create Email Addresses

Once verified, you can create email addresses on your domain:
// Your agents can now send from your domain
await jasni.emails.send({
  from: '[email protected]',
  to: '[email protected]',
  subject: 'Welcome!',
  text: 'Thanks for signing up!'
})

Subdomain Configuration

You can also configure subdomains for different purposes:
SubdomainUse Case
notifications.yourdomain.comAutomated notifications
support.yourdomain.comCustomer support agents
marketing.yourdomain.comMarketing communications
This helps with email organization and allows different sending reputations for different email types.

Troubleshooting

  • Ensure there are no typos in the DNS records
  • Check that you’re adding records to the correct domain/subdomain
  • Wait for DNS propagation (can take up to 48 hours)
  • Use a DNS checker tool to verify records are visible
  • Verify all DNS records (SPF, DKIM, DMARC) are correctly configured
  • Start with a warm-up period for new domains
  • Ensure email content follows best practices
  • Check your domain isn’t on any blocklists
  • Ensure SPF and DKIM are properly configured
  • Check DMARC reports for alignment issues
  • Verify you’re sending from an authorized address

Next Steps