Add Domain

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

Add a new sending domain to your ZeptoMail account. After adding, you must verify the domain by adding the required DNS records.

Endpoint

post /domains

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
Show Sub-Attributes
errorJSON Object
Show Sub-Attributes
codestring
messagestring
statusstring

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