- Home
- API reference
- API documentation (JSON/XML)
- Tasks
- Domain tasks
Domain create
Function
The DomainCreate task registers a domain.
In contrast to DomainCreate, DomainCreatePlus allows you to enter the data of a domain contact (handle). The domain contact is then created automatically. If a contact already exists with this data, no new one is created, but the existing one is used.
The DomainCreatePlus task is currently not supported for JSON.
Description
The keywords for the domain element are described on the Domain object page.
The keywords for the domain contact elements (ownerc, adminc, techc, zonec) for the DomainCreatePlus task are described on the Contact page.
Route: POST /domain
{
"name": "example.com",
"ownerc": {
"id": 23142212
},
"adminc": {
"id": 23142212
},
"techc": {
"id": 23142212
},
"confirmOrder": false,
"nameServers": [
{
"name": "ns1.example.com"
},
{
"name": "ns2.example.com"
}
]
}{
"stid": "20190628-app2-dev-23512",
"status": {
"code": "N0101",
"text": "Domain registration was started successfully.",
"type": "NOTIFY"
},
"object": {
"type": "Domain",
"value": "example.com"
},
"data": [
{
"created": "2019-06-28T15:12:48.000+0200",
"updated": "2019-06-28T15:12:47.000+0200",
"owner": {
"context": 4,
"user": "exampleuser"
},
"updater": {
"context": 4,
"user": "exampleuser"
},
"status": "RUNNING",
"execution": "2019-06-28T15:12:46.000+0200",
"id": 4297540445
}
]
}Task code: 0101
Uses Domain object
Example for domain create
<request>
<auth>
<user>customer</user>
<password>password</password>
<context>4</context>
</auth>
<task>
<code>0101</code>
<domain>
<name>example.com</name>
<ctid>my-ctid</ctid>
<ownerc>21653083</ownerc>
<adminc>21653083</adminc>
<techc>21653083</techc>
<zonec>21653083</zonec>
<nserver>
<name>ns1.example.com</name>
<ip>172.16.100.1</ip>
<ip6>2001:0DB8::1</ip6>
</nserver>
<nserver>
<name>ns2.example.com</name>
<ip>172.16.100.2</ip>
<ip6>2001:0DB8::2</ip6>
</nserver>
<confirm_order>1</confirm_order>
<use_trustee>1</use_trustee>
</domain>
<reply_to>customer@example.com</reply_to>
</task>
</request><response>
<result>
<data>
<domain_job>
<job>
<id>4295210866</id>
<status>RUNNING</status>
</job>
</domain_job>
</data>
<msg>
<text>Whois query: TIMEOUT (Whois-based checks without warranty.</text>
<code>MSG00003</code>
<type>notice</type>
</msg>
<status>
<code>N0101</code>
<text>Domain registration was started successfully.</text>
<type>notify</type>
<object>
<type>domain</type>
<value>example.com</value>
</object>
</status>
</result>
<stid>20180213-app3-11408</stid>
</response>