Skip to main content
Mission Inbox integrates with popular DNS providers to automate the process of setting up and managing DNS records for your domains. This eliminates manual DNS configuration and ensures accurate record deployment.

​
Supported DNS Providers

Mission Inbox currently supports integration with:

GoDaddy

Integrate your GoDaddy account to automatically manage DNS records for domains hosted on GoDaddy

Cloudflare

Connect your Cloudflare account to manage DNS records for domains using Cloudflare’s DNS services

​
How DNS Integration Works

When you connect your DNS provider API keys:
  1. Store API Credentials: Securely save your GoDaddy or Cloudflare API keys in Mission Inbox
  2. Link to Domains: Associate API keys with specific domains
  3. Automated DNS Push: Use the utility API to automatically create and push all required DNS records (MX, SPF, DKIM, DMARC)
  4. Automatic Updates: Mission Inbox team can update DNS records across all domains when needed for new releases
You can add multiple GoDaddy and Cloudflare API key pairs to manage different accounts or domains.

​
Setting Up GoDaddy Integration

​
Step 1: Create GoDaddy API Key

First, obtain your API key and secret from GoDaddy’s developer portal.

​
Step 2: Add GoDaddy API Key to Mission Inbox

const response = await fetch('https://api-v2.missioninbox.com/godaddy-keys/', {
  method: 'POST',
  headers: {
    'Authorization': 'Api-Key YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "name": "My GoDaddy Account",
    "api_key": "YOUR_GODADDY_API_KEY",
    "api_secret": "YOUR_GODADDY_API_SECRET"
  })
});

const godaddyKey = await response.json();
console.log('GoDaddy key created:', godaddyKey);

​
Step 3: List Your GoDaddy Keys

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

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

​
Setting Up Cloudflare Integration

​
Step 1: Create Cloudflare API Key

Obtain your API key from your Cloudflare account settings.

​
Step 2: Add Cloudflare API Key to Mission Inbox

const response = await fetch('https://api-v2.missioninbox.com/cloudflare-keys/', {
  method: 'POST',
  headers: {
    'Authorization': 'Api-Key YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "name": "My Cloudflare Account",
    "api_key": "YOUR_CLOUDFLARE_API_KEY",
    "email": "your-cloudflare-email@example.com"
  })
});

const cloudflareKey = await response.json();
console.log('Cloudflare key created:', cloudflareKey);

​
Step 3: List Your Cloudflare Keys

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

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

​
Pushing DNS Records Automatically

Once you’ve configured your DNS provider API keys, you can automatically push DNS records to your domains.

​
Register DNS Records for a Domain

This endpoint automatically creates and pushes all required DNS records (MX, SPF, DKIM, DMARC) to your domain: 
const domainId = 123; // Your domain ID

const response = await fetch(`https://api-v2.missioninbox.com/domain/${domainId}/register-dns-records/`, {
  method: 'POST',
  headers: {
    'Authorization': 'Api-Key YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

const result = await response.json();
console.log('DNS records registered:', result);

​
Requirements

  • Domain must have associated GoDaddy or Cloudflare API keys
  • API keys must be valid and have proper permissions
  • The API will automatically determine which provider to use based on your configured keys

​
What Gets Created

The register DNS records endpoint automatically creates:
  • MX Records: Mail exchange records for email routing
  • SPF Record: Sender Policy Framework for email authentication
  • DKIM Record: DomainKeys Identified Mail for email signing
  • DMARC Record: Domain-based Message Authentication for email policy
All DNS record values are automatically stored in the domain table for reference.

​
Managing API Keys

​
Update an API Key

GoDaddy: 
const keyId = 123;

const response = await fetch(`https://api-v2.missioninbox.com/godaddy-keys/${keyId}/`, {
  method: 'PUT',
  headers: {
    'Authorization': 'Api-Key YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "name": "Updated GoDaddy Account",
    "api_key": "NEW_API_KEY",
    "api_secret": "NEW_API_SECRET"
  })
});
Cloudflare: 
const keyId = 123;

const response = await fetch(`https://api-v2.missioninbox.com/cloudflare-keys/${keyId}/`, {
  method: 'PUT',
  headers: {
    'Authorization': 'Api-Key YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "name": "Updated Cloudflare Account",
    "api_key": "NEW_API_KEY",
    "email": "new-email@example.com"
  })
});

​
Delete an API Key

GoDaddy: 
const keyId = 123;

const response = await fetch(`https://api-v2.missioninbox.com/godaddy-keys/${keyId}/`, {
  method: 'DELETE',
  headers: {
    'Authorization': 'Api-Key YOUR_API_KEY'
  }
});
Cloudflare: 
const keyId = 123;

const response = await fetch(`https://api-v2.missioninbox.com/cloudflare-keys/${keyId}/`, {
  method: 'DELETE',
  headers: {
    'Authorization': 'Api-Key YOUR_API_KEY'
  }
});

​
Mission Inbox Managed Updates

When Mission Inbox releases new features or updates that require DNS changes, our team can handle DNS record updates for all domains that have configured DNS provider integrations. This ensures your domains stay up-to-date without manual intervention.

​
Benefits of DNS Integration

Eliminate manual DNS configuration. All records are created and pushed automatically with a single API call.
No more typos or configuration errors. DNS records are generated with exact values required for proper email delivery.
When DNS changes are needed, Mission Inbox can update all your domains automatically.
API keys are stored securely and validated before use to ensure proper permissions.
Add multiple GoDaddy and Cloudflare accounts to manage domains across different providers.

​
API Key Validation

Mission Inbox automatically validates your API keys when you add them:
  • GoDaddy: Validates that the API key and secret have proper permissions to manage DNS records
  • Cloudflare: Validates that the API key and email combination is correct and authorized
The key_valid field in the API response indicates whether validation was successful.

​
Troubleshooting

Common issues and solutions:
IssueCauseSolution
DNS registration failedMissing or invalid API keysVerify API keys are added and validated
Invalid API keyIncorrect credentialsDouble-check API key and secret/email
Permission deniedInsufficient API permissionsEnsure API keys have DNS management permissions
Domain not foundInvalid domain IDVerify the domain exists and belongs to your account

​
API Reference

For detailed API documentation, see:
  • API Keys / Cloudflare: Manage Cloudflare API keys
  • API Keys / GoDaddy: Manage GoDaddy API keys
  • Domains / Register DNS records: Automatically push DNS records to domains
Please refer to the API Reference for complete endpoint documentation.
Ready to automate DNS management? Add your DNS provider API keys and start pushing DNS records automatically. Remember to validate your API keys have proper permissions before use.