---
title: "Domain create"
url: "https://help.internetx.com/en/api/core-domain-create/"
lang: "en"
section: "API reference — API reference (XML/JSON)"
breadcrumb: "API documentation (JSON/XML) > Tasks > Domain tasks"
updated: "2023-09-18"
---

# Domain create

Function

The _DomainCreate_ task registers a domain.  
In contrast to _DomainCreate_, _[DomainCreatePlus](/en/api/core-domain-create-plus/)_ 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](/en/api/core-domain-object/) object page.  
The keywords for the domain contact elements (ownerc, adminc, techc, zonec) for the DomainCreatePlus task are described on the [Contact](/en/api/core-contact-object/) 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](/en/api/core-domain-object/) 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>
```