Skip to main content
POST
/
api
/
domains
curl -X POST https://snip.sa/api/domains \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{
    "domain": "yourdomain.com",
    "subdomain": "go"
  }'

{
  "success": true,
  "message": "Domain added successfully",
  "data": {
    "domain": {
      "_id": "507f1f77bcf86cd799439015",
      "domain": "yourdomain.com",
      "subdomain": "go",
      "fullDomain": "go.yourdomain.com",
      "status": "pending",
      "verified": false,
      "dnsRecords": [
        {
          "type": "CNAME",
          "name": "go",
          "value": "snip.sa"
        }
      ]
    }
  }
}
Custom domains are available on Pro and Enterprise plans.

​
Request Body

​
domain
string
required
Your domain name (e.g., “yourdomain.com”)
​
subdomain
string
Optional subdomain (e.g., “go” for “go.yourdomain.com”)
curl -X POST https://snip.sa/api/domains \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{
    "domain": "yourdomain.com",
    "subdomain": "go"
  }'

{
  "success": true,
  "message": "Domain added successfully",
  "data": {
    "domain": {
      "_id": "507f1f77bcf86cd799439015",
      "domain": "yourdomain.com",
      "subdomain": "go",
      "fullDomain": "go.yourdomain.com",
      "status": "pending",
      "verified": false,
      "dnsRecords": [
        {
          "type": "CNAME",
          "name": "go",
          "value": "snip.sa"
        }
      ]
    }
  }
}