Create a new domain.


Create a new domain on the SoftLayer name servers. The SoftLayer_Dns_Domain object passed to this function must have at least one A or AAAA resource record.

createObject creates a default SOA record with the data:

  • ‘‘‘host’’’: “@”
  • ‘‘‘data’’’: “”
  • ‘‘‘responsible person’’’: “root.[your domain name].”
  • ‘‘’expire’’’: 604800 seconds
  • ‘‘‘refresh’’’: 3600 seconds
  • ‘‘‘retry’’’: 300 seconds
  • ‘‘‘minimum’’’: 3600 seconds

If your new domain uses the .de top-level domain then SOA refresh is set to 10000 seconds, retry is set to 1800 seconds, and minimum to 10000 seconds.

If your domain doesn’t contain NS resource records for or then ‘‘createObject’’ will create them for you.

‘‘createObject’’ returns a Boolean ‘’true’’ on successful object creation or ‘‘false’’ if your domain was unable to be created..


Name Type Description
templateObject SoftLayer_Dns_Domain The SoftLayer_Dns_Domain object that you wish to create.

Required Headers

Optional Headers

Return Values

Error Handling

  • Throw the exception “At least one valid ‘A’ or ‘AAAA’ resource record is required to create a domain.” if the domain in the templateObject parameter doesn’t have at least one A or AAAA resource record.

Associated Methods

curl -g -u $SL_USER:$SL_APIKEY -X POST -d '{"parameters": [SoftLayer_Dns_Domain]}' \