PUT - Verify MX Record

Purpose

This API is used to verify MX record of your domain. Refer MX Records for detailed documentation.

OAuth Scope

Use the scope

ZohoMail.organization.domains.ALL (or) ZohoMail.organization.domains.UPDATE

to generate the Authtoken.

ALL - Grants full access to domains.

UPDATE - Grants update access to domains.

Request URL

Method: PUT

https://mail.zoho.com/api/organization/{zoid}/domains/{domainName}

Path Parameters

  • zoid* long
    • This parameter specifies the unique Zoho Organization Identifier for the organization.
    • This parameter can be fetched from Get Organization Details API.
  • domainName* string
    • This parameter specifies the domain name for which you want to verify MX record.

 

Request Body(JSON Object)

  • mode* string
    • This parameter represents the type of operation that is to be performed.
    • Provide the value as verifyMxRecord.

 

* - Mandatory parameter

Response Codes

Refer here for the response codes and their meaning.

Sample Request

Copiedcurl "https://mail.zoho.com/api/organization/1234567890/domains/zylkernew.com" \
-X PUT \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization:Zoho-oauthtoken *****" \
-d '{ 
"mode":"verifyMxRecord" 
}'

Sample Success Response

Copied{
   "status": {
       "code": 200,
       "description": "success"
   },
   "data": {
       "mxstatus": true
   }
}

Sample Failure Response (If the domain is not verified)

Copied{
   "status": {
       "code": 400,
       "description": "Invalid Input"
   },
   "data": {
       "moreInfo": "zylkernew.com is not verified"
   }
}

Sample Failure Response (If the MX Record is not verified)

Copied{
   "status": {
       "code": 200,
       "description": "success"
   },
   "data": {
       "mxstatus": false,
       "mxRecords": []
   }
}