domains

Add Domain

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

post/domains

Request

  • Base URL
    https://cpaas.zoho.com/v1.1
  • Auth
    • OAuth 2
      Authorization code: https://accounts.zoho.com/oauth/v2/auth
      Token URL: https://accounts.zoho.com/oauth/v2/token scopes: Zeptomail.Domains.CREATE
    • or OAuth 2
      Authorization code: https://accounts.zoho.com/oauth/v2/auth
      Token URL: https://accounts.zoho.com/oauth/v2/token scopes: Zeptomail.Domains.ALL

Request body

domain_namestring required

The domain name to add (e.g., zylker.com).

sub_domain_prefixstring

Optional subdomain prefix for bounce tracking. For example, "mail" results in "mail.zylker.com".

Example request

{
  "domain_name": "zylker.com",
  "sub_domain_prefix": "mail"
}

Response

Domain added successfully.

statusstring

Example response

{
  "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"
}

Changes

No recorded changes to this operation across all 1 revision of this API.