### DMARC DNS Record Setup

Source: https://docs.mxroute.com/docs/troubleshooting/550-5-7-515.html

Publish this TXT record in your domain's DNS to set up DMARC. This is a safe starting point.

```text
Type| Host/Name| Value
---|---|---
TXT| `_dmarc`| `v=DMARC1; p=none; sp=none; adkim=r; aspf=r;`
```

--------------------------------

### Client Welcome Email Template

Source: https://docs.mxroute.com/docs/reseller/managing_multiple_servers.html

Use this template to provide new clients with essential server details and setup instructions. Ensure sensitive information like passwords is provided separately.

```text
Welcome to [Your Company] Email Services!

Your email server details:
- Server: mx01.yourdomain.com
- Webmail Access: https://mx01.yourdomain.com/webmail
- Username: [client's email]
- Password: [provided separately]

For email client setup, use:
- Incoming (IMAP): mail.mx01.yourdomain.com, Port 993, SSL
- Outgoing (SMTP): mail.mx01.yourdomain.com, Port 587, STARTTLS

```

--------------------------------

### DKIM DNS Record Setup

Source: https://docs.mxroute.com/docs/troubleshooting/550-5-7-515.html

Add or verify this TXT record in your domain's DNS to configure DKIM. The 'Host/Name' must be exactly 'x._domainkey'.

```text
Type| Host/Name| Value
---|---|---
TXT| `x._domainkey`| Your DKIM key from the panel
```

--------------------------------

### Quick Setup: Safe DMARC Record

Source: https://docs.mxroute.com/docs/dns/dmarc.html

Use this basic DMARC record for monitoring without affecting email delivery. It applies relaxed alignment and does not require report management.

```dns
Type: TXT
Host: _dmarc
Value: v=DMARC1; p=none; sp=none; adkim=r; aspf=r;
```

--------------------------------

### Advanced DMARC: Monitoring Only

Source: https://docs.mxroute.com/docs/dns/dmarc.html

This DMARC record enables monitoring with reporting enabled. It uses a 'p=none' policy, suitable for initial setup and analysis.

```dns
v=DMARC1; p=none; rua=mailto:dmarc@yourdomain.com; ruf=mailto:dmarc-forensic@yourdomain.com; fo=1;
```

--------------------------------

### Send Email via SMTP API using Node.js

Source: https://docs.mxroute.com/docs/api/smtp-api.html

This Node.js example uses the 'node-fetch' library to send an email via the MXroute SMTP API. It sends a JSON payload and handles the asynchronous response.

```javascript
const fetch = require('node-fetch');

const data = {
    server: 'tuesday.mxroute.net',
    username: 'noreply@yourdomain.com',
    password: 'your_password',
    from: 'noreply@yourdomain.com',
    to: 'customer@example.com',
    subject: 'Welcome!',
    body: '<p>Welcome to our service!</p>'
};

fetch('https://smtpapi.mxroute.com/', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => {
    if (result.success) {
        console.log('Email sent successfully!');
    } else {
        console.error('Error:', result.message);
    }
});
```

--------------------------------

### Success Response from SMTP API

Source: https://docs.mxroute.com/docs/api/smtp-api.html

Example of a successful JSON response from the MXroute SMTP API, indicating that the email was sent without errors.

```json
{
  "success": true,
  "message": "Email sent successfully."
}
```

--------------------------------

### Basic imapsync Command for Migration

Source: https://docs.mxroute.com/docs/migrate-to-mxroute.html

Use this command structure for migrating emails between IMAP servers using imapsync. Ensure you replace placeholder server details, usernames, and passwords with your actual credentials.

```bash
imapsync --host1 source.server.com --user1 source@example.com --password1 'sourcepassword' \
         --host2 mail.mxroute.com --user2 destination@example.com --password2 'destinationpassword'
```

--------------------------------

### MXroute SPF Include Options

Source: https://docs.mxroute.com/docs/spf-records.html

Use either of these include options in your DNS TXT record. They point to the same MXroute infrastructure.

```dns
include:mxroute.com
```

```dns
include:mxlogin.com
```

--------------------------------

### WHMCS Provisioning Module

Source: https://docs.mxroute.com/docs/changelog/mxroute-4.0.1.html

A WHMCS provisioning module for resellers to automate email hosting management. It integrates with the MXroute API to handle the full account lifecycle, including provisioning, suspension, termination, password changes, and package management.

```APIDOC
## WHMCS Provisioning Module

### Description
A WHMCS provisioning module is available for resellers to automate email hosting management through WHMCS. It integrates with the MXroute API to handle the full account lifecycle.

### Key Features
- **Automatic provisioning**: New accounts are created via the API when orders are activated.
- **Suspend/unsuspend/terminate**: Account lifecycle managed directly from WHMCS.
- **Package management**: Assign MXroute packages to products, with optional quota overrides.
- **Username generation**: Auto-generate usernames with configurable prefixes.
- **Daily usage sync**: Disk usage is synced automatically for quota tracking.
- **Client area**: Customers see their server details, webmail link, and DNS configuration instructions.

### Availability
The module and API key are available in the control panel at panel.mxroute.com under **Reseller > WHMCS Integration**.
```

--------------------------------

### Recommended MXroute SPF Record

Source: https://docs.mxroute.com/docs/spf-records.html

Add this TXT record to your domain's DNS settings. The '-all' qualifier ensures strong protection against spoofing.

```dns
Type    Name    Value
TXT     @       v=spf1 include:mxroute.com -all
```

```dns
Type    Name    Value
TXT     @       v=spf1 include:mxlogin.com -all
```

--------------------------------

### Error Response from SMTP API

Source: https://docs.mxroute.com/docs/api/smtp-api.html

Example of an error JSON response from the MXroute SMTP API, detailing the reason for failure. Common errors include invalid server, missing fields, invalid JSON, or authentication failures.

```json
{
  "success": false,
  "message": "Invalid server specified."
}
```

--------------------------------

### Add SPF Record for MXroute

Source: https://docs.mxroute.com/docs/managing-domains.html

Configure your SPF record by adding this TXT record at your DNS provider. Ensure it includes 'include:mxroute.com' for proper mail authentication.

```dns
TXT @ v=spf1 include:mxroute.com -all
```

--------------------------------

### MXroute Email Hosting API

Source: https://docs.mxroute.com/docs/changelog/mxroute-4.0.1.html

A public REST API is available for programmatic management of email hosting services. It supports managing domains, email accounts, forwarders, spam settings, catch-all configurations, DNS information, quota monitoring, and reseller management. Authentication requires specific headers, and rate limits are enforced.

```APIDOC
## MXroute Email Hosting API

### Description
A public REST API is now available at api.mxroute.com for programmatic management of your email hosting.

### Base URL
api.mxroute.com

### Authentication
Requires three headers on every request:
- `X-Server`: Your mail server hostname
- `X-Username`: Your DirectAdmin username
- `X-API-Key`: Generated from the control panel (Advanced > API Keys)

### Rate Limits
- Read operations: 100 requests/minute
- Write operations: 20 requests/minute

### Endpoints
- **Domains**: Add, remove, and configure domains with automated DNS verification.
- **Email Accounts**: Create, update, and delete email accounts with custom quotas and send limits.
- **Forwarders**: Set up and manage email forwarding rules.
- **Spam Settings**: Configure spam thresholds, whitelists, and blacklists.
- **Catch-All**: Configure catch-all behavior (reject, discard, or forward).
- **DNS Information**: Retrieve MX, SPF, DKIM, and verification records.
- **Quota**: Monitor disk usage across your account and individual email accounts.
- **Reseller Management**: Manage users and packages (reseller accounts only).

### Full Documentation
Full documentation, including the OpenAPI specification, is available at api.mxroute.com.
```

--------------------------------

### Create CNAME Records for Numbered Subdomains

Source: https://docs.mxroute.com/docs/reseller/managing_multiple_servers.html

Use CNAME records to point your numbered subdomains to the appropriate MXroute server. This ensures that traffic is correctly routed to the server hosting the client's package.

```dns
mx01.yourdomain.com    CNAME    safari.mxrouting.net
mx02.yourdomain.com    CNAME    lucy.mxrouting.net
mx03.yourdomain.com    CNAME    everest.mxrouting.net
```

--------------------------------

### Advanced DMARC: Partial Quarantine

Source: https://docs.mxroute.com/docs/dns/dmarc.html

Implement a partial quarantine policy for DMARC, sending a percentage of failing emails to spam. Reporting is included.

```dns
v=DMARC1; p=quarantine; pct=25; rua=mailto:dmarc@yourdomain.com; ruf=mailto:dmarc-forensic@yourdomain.com;
```

--------------------------------

### SPF Record Configuration for MXroute

Source: https://docs.mxroute.com/docs/troubleshooting/550-5-7-515.html

Use this SPF record if MXroute is your only email service. Ensure your domain has only one SPF record.

```text
v=spf1 include:mxroute.com -all
```