Verifying a sending domain

Verify your sender domain to start sending emails to your recipients.

Request Type

  • POST

Request URL

https://campaigns.zoho.com/emailapi/v1/settings/domain/verify

Content-Type

application/json

List of Request Body Attributes

Parameters

Data Type

Description

domain*

String

Name of the domain from which emails will be sent. It will be displayed in the "From" header of the email.

List of Response Body Attributes

ParametersData TypeDescription
verify_resultJSON ObjectContains the sending and bounce domain details.
sending_domainBooleanReturns a true or false value depending on the domain's verification status.
bounce_domainBooleanReturns a true or false value depending on the domain's verification status.
responseJSON ObjectContains the response details of the API.
codeIntegerSuccess or failure code.
messageStringSuccess or failure message returned by the API.

Possible Errors

Error Codes

Description

400101Domain name not provided

400102

Invalid domain name

400104

No such domain configured

400106

Domain already verified in another org

400107

Domain verification failed due to missing public key in DNS

 

Sample Request Payload

Copied{
 "domain": "zylker.in"
}

Sample Response - Success

Copied{
   "verify_result": {
      "sending_domain": true,
       "bounce_domain": true
   },
   "response": {
       "code": 200103,
       "message": "Domain verification successful"
   }
}

Sample Response - Failure

Copied{
   "verify_result": {
       "sending_domain": false,
       "bounce_domain": false
   },
   "response": {
       "code": 400107,
       "message": "Domain verification failed. Please make sure that the public key is added in DNS"
   }
}