Skip to content
WHM API1
/
Domain Management
/
Create mail exchanger record

WHM API (11.134.0.5)

WHM API.

https://cpanel.net/developers/
Download OpenAPI description
whm.openapi.json
whm.openapi.yaml
Overview
URL

https://cpanel.net/support/

WebPros International, LLC

cs@cpanel.net

License

cPanel License

Terms of Service

Languages
Servers
Mock server

https://api.docs.cpanel.net/_mock/specifications/whm.openapi/

A server running WHM.

https://{host}:{port}/json-api/

Restore Account

Account Restoration / Restore Account

Operations

Restore Queue Management

Account Restoration / Restore Queue Management

Operations

Restore Queue Reporting

Account Restoration / Restore Queue Reporting

Operations

Account Creation

Accounts Creation / Accounts

Operations

Account Enhancements

Accounts / Account Enhancements

Operations

Account Management

Accounts / Account Management

Operations

Bandwidth and Disk Quotas

Accounts / Bandwidth and Disk Quotas

Operations

Domain Information

Accounts / Domain Domain Information

Operations

Passwords

Accounts / Passwords

Operations

Styles

The Styles and Themes module for WHM API 1.

Operations

Suspensions

Accounts / Suspensions

Operations

API Execution

API Development Tools / API Execution

Operations

API Statistics

API Development Tools / API Statistics

Operations

API Token Management

API Development Tools / API Token Management

Operations

Applications

API Development Tools / Applications

Operations

Session

API Development Tools / Session

Operations

Authentication Providers

Authentication / Authentication Providers

Operations

External Authentication

Authentication / External Authentication

Operations

Login URL

Authentication / Login URL

Operations

SSH Keys and Connections

Authentication / SSH Keys and Connections

Operations

Two-Factor Authentication

Authentication / Two-Factor Authentication

Operations

Backup Destination

Backups / Backup Destination

Operations

Backup or Restore

Backups / Backup or Restore

Operations

Backup Settings

Backups / Backup Settings

Operations

Legacy Migration

Backups / Legacy Migration

Operations

Market Integration

Commerce Integration / Market Integration

Operations

Sitejet

The Sitejet module for WHM API.

Operations

Product Management

cPanel Market / Product Management

Operations

Provider Management

cPanel Market / Provider Management

Operations

Support Access

cPanel Support Tickets / Support Access

Operations

Ticket Management

cPanel Support Tickets / Ticket Management

Operations

Customizations

The Customizations module for WHM API 1.

Operations

Manage MySQL Server

Databases / Manage MySQL Server

Operations

MySQL Databases

Databases / MySQL Databases

Operations

PostgreSQL Databases

Databases / PostgreSQL Databases

Operations

Remote MySQL Databases

Databases / Remote MySQL Databases

Operations

DNS Cluster Settings

DNS / DNS Cluster Settings

Operations

DNS Security

DNS / DNS Security

Operations

DNS Zones

DNS / DNS Zones

Operations

Domain Management

DNS / Domain Management

Operations

Return domain's IP address

Request

This function resolves a domain's IPv4 address.

Security
BasicAuth
Query
domainstring(domain)required

The domain.

Example: domain=example.com
curl -i -X GET \
  -u <username>:<password> \
  'https://api.docs.cpanel.net/_mock/specifications/whm.openapi/resolvedomainname?domain=example.com'

Responses

HTTP Request was successful.

Bodyapplication/json
dataobject
metadataobject
Response
application/json
{
  "data": {
    "ip": "192.168.0.20"
  },
  "metadata": {
    "command": "resolvedomainname",
    "reason": "OK",
    "result": 1,
    "version": 1
  }
}

Create mail exchanger record

Request

This function creates a new MX record.

Important:

When you disable the DNS role, the system disables this function.

Security
BasicAuth
Query
domainstring(domain)required

The zone record's domain.

Example: domain=example.com
exchangestring(domain)required

The domain's mail exchanger.

Example: exchange=mail.example.com
namestringrequired

The record name.

Example: name=mail.example.com
preferenceinteger>= 1required

The MX record's priority order.

Note:

Lower numbers indicate a higher priority order.

Example: preference=20
classstring

The record's class.

Default "IN"
Example: class=IN
ttlinteger>= 1

The record's Time To Live (TTL) in seconds.

Default 14400
Example: ttl=14400
curl -i -X GET \
  -u <username>:<password> \
  'https://api.docs.cpanel.net/_mock/specifications/whm.openapi/savemxs?domain=example.com&exchange=mail.example.com&name=mail.example.com&preference=20&class=IN&ttl=14400'

Responses

HTTP Request was successful.

Bodyapplication/json
metadataobject
Response
application/json
{
  "metadata": {
    "command": "savemxs",
    "reason": "Bind reloading on server1 using rndc zone: [example.com]\n",
    "result": 1,
    "version": 1
  }
}

Enable NSEC3 semantics for domain

Request

This function configures the domain to use Next Secure Record 3 (NSEC3) semantics.

Note:

Only servers that run PowerDNS can use DNSSEC. If you call this function on a server that doesn't use PowerDNS, you will receive an error.

Security
BasicAuth
Query
domainstring(domain)required

The domain for which to enable NSEC3 semantics.

Example: domain=example.com
nsec3_iterationsinteger[ 0 .. 500 ]required

The number of times that the system re-executes the first resource record hash operation.

Example: nsec3_iterations=7
nsec3_narrowintegerrequired

Whether NSEC3 will operate in Narrow mode or Inclusive mode.

Note

For information about these modes, read PowerDNS's DNSSEC documentation.

  • 1 - Narrow mode.
  • 0 - Inclusive mode.
Enum01
Example: nsec3_narrow=1
nsec3_opt_outintegerrequired

Whether the system will create records for all delegations.

  • 1 - Create records for all delegations.
  • 0 - Create records only for secure delegations.

Note

Only select 1 if you must create records for all delegations.

Enum01
Example: nsec3_opt_out=0
nsec3_saltstringrequired

The salt value that PowerDNS uses in the hashes.

Note:

For information about salt values, read RFC 5155.

Example: nsec3_salt=1a2b3c4d5e6f
curl -i -X GET \
  -u <username>:<password> \
  'https://api.docs.cpanel.net/_mock/specifications/whm.openapi/set_nsec3_for_domains?domain=example.com&nsec3_iterations=7&nsec3_narrow=1&nsec3_opt_out=0&nsec3_salt=1a2b3c4d5e6f'

Responses

HTTP Request was successful.

Bodyapplication/json
dataobject
metadataobject
Response
application/json
{
  "data": {
    "domains": [ … ]
  },
  "metadata": {
    "command": "set_nsec3_for_domains",
    "reason": "OK",
    "result": 1,
    "version": 1
  }
}

Domain Management

DNS / Domain Management

Operations

Return domain's IP address

Request

This function resolves a domain's IPv4 address.

Security
BasicAuth
Query
domainstring(domain)required

The domain.

Example: domain=example.com
curl -i -X GET \
  -u <username>:<password> \
  'https://api.docs.cpanel.net/_mock/specifications/whm.openapi/resolvedomainname?domain=example.com'

Responses

HTTP Request was successful.

Bodyapplication/json
dataobject
metadataobject
Response
application/json
{
  "data": {
    "ip": "192.168.0.20"
  },
  "metadata": {
    "command": "resolvedomainname",
    "reason": "OK",
    "result": 1,
    "version": 1
  }
}

Create mail exchanger record

Request

This function creates a new MX record.

Important:

When you disable the DNS role, the system disables this function.

Security
BasicAuth
Query
domainstring(domain)required

The zone record's domain.

Example: domain=example.com
exchangestring(domain)required

The domain's mail exchanger.

Example: exchange=mail.example.com
namestringrequired

The record name.

Example: name=mail.example.com
preferenceinteger>= 1required

The MX record's priority order.

Note:

Lower numbers indicate a higher priority order.

Example: preference=20
classstring

The record's class.

Default "IN"
Example: class=IN
ttlinteger>= 1

The record's Time To Live (TTL) in seconds.

Default 14400
Example: ttl=14400
curl -i -X GET \
  -u <username>:<password> \
  'https://api.docs.cpanel.net/_mock/specifications/whm.openapi/savemxs?domain=example.com&exchange=mail.example.com&name=mail.example.com&preference=20&class=IN&ttl=14400'

Responses

HTTP Request was successful.

Bodyapplication/json
metadataobject
Response
application/json
{
  "metadata": {
    "command": "savemxs",
    "reason": "Bind reloading on server1 using rndc zone: [example.com]\n",
    "result": 1,
    "version": 1
  }
}

Enable NSEC3 semantics for domain

Request

This function configures the domain to use Next Secure Record 3 (NSEC3) semantics.

Note:

Only servers that run PowerDNS can use DNSSEC. If you call this function on a server that doesn't use PowerDNS, you will receive an error.

Security
BasicAuth
Query
domainstring(domain)required

The domain for which to enable NSEC3 semantics.

Example: domain=example.com
nsec3_iterationsinteger[ 0 .. 500 ]required

The number of times that the system re-executes the first resource record hash operation.

Example: nsec3_iterations=7
nsec3_narrowintegerrequired

Whether NSEC3 will operate in Narrow mode or Inclusive mode.

Note

For information about these modes, read PowerDNS's DNSSEC documentation.

  • 1 - Narrow mode.
  • 0 - Inclusive mode.
Enum01
Example: nsec3_narrow=1
nsec3_opt_outintegerrequired

Whether the system will create records for all delegations.

  • 1 - Create records for all delegations.
  • 0 - Create records only for secure delegations.

Note

Only select 1 if you must create records for all delegations.

Enum01
Example: nsec3_opt_out=0
nsec3_saltstringrequired

The salt value that PowerDNS uses in the hashes.

Note:

For information about salt values, read RFC 5155.

Example: nsec3_salt=1a2b3c4d5e6f
curl -i -X GET \
  -u <username>:<password> \
  'https://api.docs.cpanel.net/_mock/specifications/whm.openapi/set_nsec3_for_domains?domain=example.com&nsec3_iterations=7&nsec3_narrow=1&nsec3_opt_out=0&nsec3_salt=1a2b3c4d5e6f'

Responses

HTTP Request was successful.

Bodyapplication/json
dataobject
metadataobject
Response
application/json
{
  "data": {
    "domains": [ … ]
  },
  "metadata": {
    "command": "set_nsec3_for_domains",
    "reason": "OK",
    "result": 1,
    "version": 1
  }
}

Resolvers

DNS / Resolvers

Operations

Service Records

DNS / Service Records

Operations

Feature Access

Hosting Plans / Feature Access

Operations

Feature Lists

Hosting Plans / Feature Lists

Operations

Hosting Plan Extensions

Hosting Plans / Hosting Plan Extensions

Operations

Hosting Plans

Hosting Plans / Hosting Plans

Operations

InProductSurvey

In-product survey information.

Operations

API Authentication

Integrations / API Authentication

Operations

Scripts Hooks

Integrations / Scripts Hooks

Operations

IPv4 Address Settings

IP Address Management / IPv4 Address Settings

Operations

IPv6 Address Settings

IP Address Management / IPv6 Address Settings

Operations

Network Address Translation

IP Address Management / Network Address Translation

Operations

Management

Login Security (cPHulk) / Management

Operations

Reporting

Login Security (cPHulk) / Reporting

Operations

Settings

Login Security (cPHulk) / Settings

Operations

cPanel Account Mail Management

Mail / cPanel Account Mail Management

Operations

Mail DNS Settings

Mail / Mail DNS Settings

Operations

Mail Server Settings

Mail / Mail Server Settings

Operations

Spam Management

Mail / Spam Management

Operations

Spam Protection (Greylisting)

Mail / Spam Protection (Greylisting)

Operations

NGINX Manager

The NGINX Manager module for WHM API 1.

Operations

Account Enhancement Limit

Resellers / Account Enhancement Limit

Operations

Account Limits

Resellers / Account Limits

Operations

Account Permissions

Resellers / Account Permissions

Operations

Account Settings

Resellers / Account Settings

Operations

Reseller Account Management

Resellers / Account Management

Operations

WHM Access

Security / WHM Access

Operations

Configuration Clusters

Server Administration / Configuration Clusters

Operations

Configurations

Server Administration / Configurations

Operations

Connected Applications

Server Administration / Connected Applications

Operations

Connections

Server Administration / Connections

Operations

cPanel Analytics

The cPanel Analytics module for WHM API 1.

Operations

License Management

The Server Administration module for WHM API 1.

Operations

Notifications

Server Administration / Notifications

Operations

Plugin-Based Features

The plugin-based features module for WHM API 1.

Operations

Security

The Security module for WHM API 1.

Operations

Server Nodes

Server Administration / Server Nodes

Operations

Server Profiles

Server Administration / Server Profiles

Operations

Services

Server Administration / Services

Operations

System Information

The Server Administration module for WHM API 1.

Operations

Updates

Server Administration / Updates

Operations

Auto-Generated Certificates

SSL Certificates / Auto-Generated Certificates

Operations

cPanel Account Settings

SSL Certificates / cPanel Account Settings

Operations

SSL Server Settings

SSL Certificates / SSL Server Settings

Operations

Install or Uninstall Package

System Package Management / Install or Uninstall Package

Operations

List Package Information

System Package Management / List Package Information

Operations

Package Manager Settings

System Package Management / Package Manager Settings

Operations

cPanel Account Transfer

Transfers / cPanel Account Transfer

Operations

Transfer Configuration

Transfers / Transfer Configuration

Operations

Transfer Monitoring

Transfers / Transfer Monitoring

Operations

UserData

Scoped userdata storage functions.

Operations

EasyApache Settings

Web Server Configuration / EasyApache Settings

Operations

PHP

The PHP module for WHM API 1.

Operations

PHP-FPM

Web Server Configuration / PHP-FPM

Operations

Rule Settings

Web Server Security (ModSecurity) / Rule Settings

Operations

Rule Vendor Settings

Web Server Security (ModSecurity) / Rule Vendor Settings

Operations

Server Settings

Web Server Security (ModSecurity) / Server Settings

Operations