Add Domain
Add a new sending domain to your ZeptoMail account. After adding, you must verify the domain by adding the required DNS records.
Endpoint
Copy full URL
Request URL
https://api.zeptomail.com/v1.1/domains Copied!
Scope
Zeptomail.Domains.CREATECopied!
(or)
Zeptomail.Domains.ALLCopied!
- Request Body
application/json
JSON Object
Show Sub-Attributes
domain_namestringMandatory
The domain name to add (e.g., zylker.com).
sub_domain_prefixstringOptional
Optional subdomain prefix for bounce tracking. For example, "mail" results in "mail.zylker.com".
Sample Request
Curl
Java
Python
Deluge
Copied!
curl --request POST \
--url https://api.zeptomail.com/v1.1/domains \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'content-type: application/json' \
--data '{"domain_name":"zylker.com","sub_domain_prefix":"mail"}'Sample Request Body
Copied!
{
"domain_name": "zylker.com",
"sub_domain_prefix": "mail"
}
▼ Show full
Response Parameters
- HTTP code 200
Response Body - application/json
JSON Object
Show Sub-Attributes
dataJSON Object
Show Sub-Attributes
dkim_statusstring
created_timestring
domain_namestring
domain_keystring
sub_domain_prefixstring
spf_statusstring
is_verifiedboolean
statusstring
- HTTP code 400
Response Body - application/json
JSON Object
Possible Response Codes
200HTTP code
Domain added successfully.
400HTTP code
Bad Request
Sample Response: HTTP 200
Copied!
{
"data": {
"dkim_status": "verified",
"created_time": "2025-06-04T08:19:00Z",
"domain_name": "zylker.com",
"domain_key": "domain-xxxx",
"sub_domain_prefix": "mail",
"spf_status": "verified",
"is_verified": true
},
"status": "success"
}
▼ Show full
Sample Response: HTTP 400
Copied!
{
"error": {
"code": "DM_400",
"message": "Invalid domain"
},
"status": "failure"
}
▼ Show full
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.