Skip to main content
Mission Inbox provides automated DNS record management through API integrations with popular DNS providers. This eliminates the need for manual DNS configuration and streamlines the domain setup process.

Supported Platforms

Mission Inbox currently supports automated DNS management for the following platforms:

GoDaddy

Integrate with GoDaddy’s DNS management API for automatic record handling

Cloudflare

Connect with Cloudflare’s API for seamless DNS zone management

Setting Up API Integration

To enable automated DNS management, you need to provide your DNS provider’s API credentials:
1

Login to Mission Inbox

Access your Mission Inbox account dashboard
2

Navigate to Integrations

Go to Settings > Integrations section
3

Add Provider Credentials

Add your GoDaddy or Cloudflare API keys to enable integration
4

Verify Connection

Test the connection to ensure proper API access

GoDaddy Integration

For GoDaddy integration, you’ll need:
  • API Key: Your GoDaddy API key
  • API Secret: Your GoDaddy API secret
  • Domain Access: Ensure the API key has permissions to manage your domains

Cloudflare Integration

For Cloudflare integration, you’ll need:
  • API Token: Your Cloudflare API token with zone edit permissions
  • Zone Access: Token must have access to the zones you want to manage

Automated Domain Workflow

Once your API integration is configured, Mission Inbox automatically handles:
Automatically pushes SPF, DKIM, DMARC, and other necessary DNS records to your DNS zone
Identifies the correct DNS zone for your domain and manages record placement
Automatically triggers domain verification once DNS records are in place
Monitors and updates domain verification status in real-time

Creating Domains with Automation

When creating domains with automated DNS management enabled, the process becomes seamless:
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 with automation:', domain);
With automation enabled:
  1. DNS records are automatically pushed to your DNS provider
  2. Domain verification is automatically triggered
  3. Status updates occur in real-time

Monitoring Domain Status

Since domain verification happens automatically, you need to poll the domain verification endpoint to check verification progress:
// Function to check domain verification status
async function checkDomainVerification(domainId) {
  const response = await fetch(`https://api-v2.missioninbox.com/api/domains/${domainId}/`, {
    method: 'PATCH',
    headers: {
      'Authorization': 'Api-Key YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  });
  
  return {
    status: response.status,
    isVerified: response.status === 200,
    isPending: response.status === 202
  };
}

// Polling function for domain verification
async function pollDomainVerification(domainId) {
  const maxAttempts = 30; // Poll for up to 5 minutes
  const interval = 10000; // 10 seconds between checks
  
  for (let attempt = 0; attempt < maxAttempts; attempt++) {
    const result = await checkDomainVerification(domainId);
    
    console.log(`Verification attempt ${attempt + 1}: Status ${result.status}`);
    
    if (result.isVerified) {
      console.log('Domain successfully verified!');
      return true;
    }
    
    if (!result.isPending) {
      console.log('Domain verification failed');
      return false;
    }
    
    // Wait before next check
    await new Promise(resolve => setTimeout(resolve, interval));
  }
  
  console.log('Verification timeout - check domain status manually');
  return false;
}

// Usage
const domainId = 'your-domain-id';
pollDomainVerification(domainId);

Domain Verification Status

The domain verification endpoint uses HTTP status codes to indicate verification status:
Status CodeDescription
200Domain fully verified and ready for use
202Verification is still pending - continue polling
4xx/5xxVerification failed - check configuration

Benefits of Automation

⚡ Speed

Instant DNS record deployment without manual intervention

🎯 Accuracy

Eliminates human errors in DNS record configuration

🔄 Consistency

Ensures all required records are properly configured

⏱️ Time Saving

Reduces domain setup time from hours to minutes

API Reference

For detailed information about the domain management API, including status updates and verification endpoints, refer to: Domain API Documentation

Troubleshooting

Common issues with automated domain management:
Ensure your DNS provider API keys have the correct permissions and are not expired
Verify that your API token has access to manage the specific domain zones
DNS changes may take time to propagate - allow up to 10 minutes for verification
Use polling to monitor domain status rather than assuming immediate verification

Ready for automation? Set up your DNS provider integration in Settings > Integrations to enable seamless domain management.