Adding a sending domain
Create and add sending domains to send emails to your recipients.
Request Type
POST
Request URL
https://campaigns.zoho.com/emailapi/v2/settings/domain
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. |
| bounce_domain | String | If provided, this will be used as the bounce domain, else, a default bounce domain will be used. |
List of Response Body Attributes
| Parameters | Data Type | Description |
| domain_name | String | Name of the sender domain. |
| response | JSON Object | Contains the response details of the API. |
| code | Integer | Success or failure code. |
| message | String | Success or failure message returned by the API. |
| sending_domain | JSON Object | Contains details of sending domain like host name, value. |
| dns_host_name | String | Host name of the sending domain. |
| dns_record_type | String | Record type of the sending domain. |
| dns_value | String | Value or key of the sending domain. |
| bounce_domain | JSON Object | Contains details of the bounced domain like host name, value. |
| is_verified | Boolean | Returns a true or false value depending on if the domain has been authenticated or not. |
| errors | JSON Array | Contains the error details of the API such as 'code' and 'message'. |
Possible Errors
Error Codes | Description |
400101 | Domain name not provided |
400102 | Invalid domain name |
400103 | Domain already exists |
| 400106 | Domain already verified in another org |
| 400109 | Bounce domain already exists |
| 400108 | Invalid bounce domain |
Sample Request Payload
Copied
Sample Response - Success
Copied
Sample Response - Failure
Copied