DIdigicert
records - primary - MX

Adds an MX record to a specific primary domain.

This endpoint creates an MX record for a specific primary domain, enabling users to associate the domain with an IP address.</br></br>Key features include:</br></br>- Clear success messaging: Returns a 200 success code with a confirmation message indicating the successful completion of the requested action.</br>- Comprehensive error handling: Returns a 400 error code with a clear description when requests fail.</br>- Seamless record creation: Facilitates the creation of an MX record in-line with the appropriate schema, ensuring smooth and efficient organization.</br>- Targeted data addition: Leverages the domainId parameter in the URL path to add a new MX record to the specified domain, ensuring accurate and focused modifications for effective domain management.

post/domains/primary/{domainId}/records/MX

Request

Path parameters

domainIdinteger required

Filters data by the domain's unique identifier.

Request body

typestring
namestring
ttlinteger
createdTsstring date-time
modifiedTsstring date-time
systemFlagboolean

Example request

{
  "type": "MX",
  "name": "testmx",
  "ttl": 1800,
  "region": {
    "gtdLocationId": 1,
    "regionName": "NA_WEST",
    "regionLabel": "NA West"
  },
  "createdTs": "2026-01-01T01:00:00.123456Z",
  "modifiedTs": "2026-01-01T01:00:00.123456Z",
  "values": [
    {
      "id": 1,
      "server": "mail1.example.com.",
      "enabled": true,
      "priority": 10,
      "sortOrder": 1
    }
  ]
}

Response

MX record created successfully.

idinteger
typestring
namestring
ttlinteger
createdTsstring date-time
modifiedTsstring date-time
systemFlagboolean

Example response

{
  "id": 1,
  "type": "MX",
  "name": "testmx",
  "ttl": 1800,
  "region": {
    "gtdLocationId": 1,
    "regionName": "NA_WEST",
    "regionLabel": "NA West"
  },
  "createdTs": "2026-01-01T01:00:00.123456Z",
  "modifiedTs": "2026-01-01T01:00:00.123456Z",
  "values": [
    {
      "id": 1,
      "server": "mail1.example.com.",
      "enabled": true,
      "priority": 10,
      "sortOrder": 1
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.