Skip to main content
Domains must be registered on Mission Inbox and associated with a specific relay server to enable email delivery. This association ensures proper authentication, deliverability tracking, and optimal performance.

​
Domain-Server Binding

Each sending domain must be associated with a relay server. This binding ensures:

🔐 Proper Authentication

Correct SPF, DKIM, and DMARC records for the chosen provider

📊 Deliverability Tracking

Accurate monitoring and analytics for domain-specific performance

🎯 Optimized Routing

Emails sent through the most appropriate infrastructure

🔄 Load Management

Distribute traffic across multiple servers when needed

​
Creating Domains

There are two ways to create domains on Mission Inbox:

​
1. Single Domain Creation

Create domains one by one using the API with the following payload: 
const response = await fetch('https://api-v2.missioninbox.com/api/domains/', {
  method: 'POST',
  headers: {
    'Authorization': 'Api-Key YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "name": "yourdomain.com",
    "relay_server": 123,
    "project": 456,
    "redirect": "http://example.com"
  })
});

const domain = await response.json();
console.log('Domain created:', domain);

​
2. Bulk Domain Creation

Create multiple domains at once using CSV upload for efficient bulk operations.

​
Domain Parameters

  • name: Your domain name (e.g., mail.yourdomain.com)
  • relay_server: The ID of the relay server to associate with this domain
  • project: The project ID to organize your domains
  • redirect: Optional redirect URL for tracking purposes

​
DNS Configuration

After creating a domain, Mission Inbox will provide you with the proper DNS records that need to be added to your DNS manager:
Sender Policy Framework (SPF) records authorize specific servers to send emails on behalf of your domain.
v=spf1 include:_spf.missioninbox.com ~all
DomainKeys Identified Mail (DKIM) records provide cryptographic authentication for your emails.
selector._domainkey.yourdomain.com TXT "v=DKIM1; k=rsa; p=MIGfMA0GCS..."
Domain-based Message Authentication, Reporting & Conformance (DMARC) policies protect against email spoofing.
v=DMARC1; p=quarantine; rua=mailto:dmarc@yourdomain.com
Mail Exchange (MX) records for incoming email handling (if applicable).
yourdomain.com MX 10 mx.missioninbox.com

​
Managing Multiple Domains

You can manage multiple domains across different relay servers:

​
List Your Domains

const response = await fetch('https://api-v2.missioninbox.com/api/domains/', {
  method: 'GET',
  headers: {
    'Authorization': 'Api-Key YOUR_API_KEY'
  }
});

const domains = await response.json();
console.log('Your domains:', domains);

​
Domain Verification

After creating a domain and setting up DNS records, you need to verify domain ownership:
1

Add DNS Records

Add the provided DNS records to your domain’s DNS configuration
2

Wait for Propagation

DNS changes can take up to 48 hours to propagate globally
3

Verify Domain

Use the domain verification endpoint to confirm setup
4

Start Sending

Once verified, your domain is ready for email sending

​
Verification API Call

const response = await fetch(`https://api-v2.missioninbox.com/api/domains/${domainId}/verify/`, {
  method: 'POST',
  headers: {
    'Authorization': 'Api-Key YOUR_API_KEY'
  }
});

const verification = await response.json();
console.log('Verification status:', verification);

​
Failover and Redundancy

Configure multiple relay servers for the same domain to ensure high availability:

🔄 Automatic Failover

Automatically switch to backup servers if primary server fails

⚖️ Load Balancing

Distribute email traffic across multiple servers for better performance

🌍 Geographic Distribution

Use servers in different regions for optimal delivery speeds

📊 Performance Monitoring

Track performance metrics for each server to optimize routing

​
Best Practices

Use dedicated subdomains for different types of emails (e.g., mail.yourdomain.com for transactional, newsletter.yourdomain.com for marketing).
Gradually increase sending volume on new domains to build reputation with ISPs.
Regularly check delivery rates, bounce rates, and spam complaints for each domain.
Always implement DMARC policies to protect your domain from spoofing attacks.

​
Troubleshooting

Common domain management issues and solutions:
IssueCauseSolution
Domain not verifyingDNS records not propagatedWait 24-48 hours, check DNS configuration
Low delivery ratesPoor domain reputationImplement gradual warmup, check content quality
Authentication failuresIncorrect DKIM/SPF setupVerify DNS records match provided values
Bounced emailsInvalid MX recordsEnsure MX records point to correct servers

​
API Reference

For detailed information about all domain management APIs, including:
  • Creating domains (single and bulk)
  • Updating domain settings
  • Retrieving domain information
  • Domain verification
  • DNS record management
Please refer to the API Reference section.
Ready to set up your domain? Make sure you have access to your DNS management interface before creating domains in Mission Inbox. Detailed management APIs can be found in the API reference.