The create command allows you to register a domain name, other objects can be created only as part of the domain name creation operation. In addition to the standard EPP command elements, the create command MUST contain a domain:create command that identifies the domain namespace and the location of the domain schema.

We recommend that you first read about field definitions and registrant types, which will explain the allowable values in for the data described below.

Domains

To register a domain via EPP you need to provide the following information:

• The details of the domain itself.
• Details of a new registrant contact or the ID of an existing registrant contact.
  
• Details of the nameservers.

The identifiers of contact objects created as part of the operation are returned in the response.

<domain:create> element

The <domain:create> element contains the following child elements:

• A <domain:name> element. More than one <domain:name> element can be given here to create multiple domain names on the same account. To create multiple domain names on a single account, the 1.1 versions of the nom- schemas must be used.
  
• An optional <domain:period> element.
• A <domain:account> element. This contains either:
  • a <domain:account-id> element containing the identifier of the registrant contact object to be used for the domain name; or
    
  • an <account:create> element defining the sub-elements of a  object to be created and used.
    
• An optional <domain:ns> element containing the nameservers in order for the domain name. This has one to ten <domain:host> sub-elements, each of which will contain the following child elements
  
  • A <domain:hostName> element giving the name of the host object.
  • Optional <domain:hostAddr> elements giving the ip addresses of the host object. This element should be provided only if the nameserver needs glue records. It should have an "ip" attribute of "v4" or "v6" indicating the ip version. A maximum of one ipv4 and one ipv6 address can be provided.
• An optional <domain:first-bill>
• An optional <domain:recur-bill>
• An optional <domain:auto-bill>
• An optional <domain:next-bill> The <domain:next-bill> element is removed after renewal.
• An optional <domain:notes> 
• An optional <domain:reseller> element. Note that this is only available in the 2.0 versions of the nom- schemas

<domain:creData> element

The <domain:creData> element is returned in the response and describes the domain name that has been created.  It contains the following sub-elements:

• A <domain:name> element.
• If an account object was created for the registrant, a <domain:account> field containing an <account:creData> sub-element giving details of the created account object. The <account:creData> element is described below.
• A <domain:crDate> element.
• A <domain:exDate> element .
  

If multiple <domain:name> elements are provided in the request, the <domain:creData> element will be repeated for each domain name.

Registrant contacts

Registrant contacts can only be created as part of the domain creation process using the Nominet EPP schemas.  Once a registrant contact has been created you can add domains to it by specifying the ID of the contact.

<account:create> element

The <account:create> element will have the following sub-elements:

• An <account:name> element.
• An optional <account:trad-name> element.
• An <account:type> element.
  
• An <account:opt-out> element.
• An <account:contact> element containing a single <contact:create> element which is described below.
  
•  An <account:addr> element giving the registrant's address. The <account:addr> element has the following sub-elements defining the parts of the address:
  • <account:street>
  • <account:city>
  • <account:county>
  • <account:postcode>
  • <account:country>

<account:creData> element

The <account:creData> element is returned in a response and describes the account object that has been created.  It contains the following sub-elements:

• An <account:roid> element giving the repository object identifier for the domain name. An <account:name> element giving the name of the account holder (registrant of the domain name).

<contact:create> element

The <contact:create> element has the following sub-elements:

• A <contact:name> element.
• A <contact:email> element.
• An optional <contact:phone> element
  

Examples

Registering a domain and creating a new account

This is an example of a create command where the account id is not known and a new account object is created. Two existing nameservers are referenced and a new one is created and then referenced:

    <?xml version="1.0" encoding="UTF-8" standalone="no"?>
      <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
           xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0
           epp-1.0.xsd">
       <command>
        <create>
         <domain:create
          xmlns:domain="http://www.nominet.org.uk/epp/xml/nom-domain-2.0"
          xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/nom-domain-2.0
          nom-domain-2.0.xsd">
          <domain:name>example.co.uk</domain:name>
          <domain:period>2</domain:period>
          <domain:account>
           <account:create
            xmlns:account="http://www.nominet.org.uk/epp/xml/nom-account-2.0"
            xmlns:contact="http://www.nominet.org.uk/epp/xml/nom-contact-2.0">
           <account:name>Mr R. Strant</account:name>
           <account:trad-name>R. S. Industries</account:trad-name>
           <account:type>LTD</account:type>
           <account:co-no>NI123456</account:co-no>
           <account:opt-out>N</account:opt-out>
           <account:addr>
            <account:street>2102 High Street</account:street>
            <account:city>Oxford</account:city>
            <account:county>Oxfordshire</account:county>
            <account:postcode>OX1 1DF</account:postcode>
            <account:country>GB</account:country>
           </account:addr>
           <account:contact>
            <contact:create>
              <contact:name>Mr R. Strant</contact:name>
              <contact:phone>01865 123456</contact:phone>
              <contact:email>r.strant@strant.co.uk</contact:email>
            </contact:create>
           </account:contact>
          </account:create>
         </domain:account>
         <domain:ns>
          <domain:host>
           <domain:hostName>ns0.epp-example.com</domain:hostName>
          </domain:host>
          <domain:host>
           <domain:hostName>ns0.epp-example.co.uk</domain:hostName>
           <domain:hostAddr ip="v4">111.123.145.121</domain:hostAddr>
           <domain:hostAddr ip="v6">abcd::1234</domain:hostAddr>
          </domain:host>
         </domain:ns>
         <domain:recur-bill>th</domain:recur-bill>
        </domain:create>
       </create>
      <clTRID>ABC-12345</clTRID>
     </command>
    </epp>

Registering a new domain onto an existing account

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0
      epp-1.0.xsd">
   <command>
     <create>
       <domain:create
        xmlns:domain="http://www.nominet.org.uk/epp/xml/nom-domain-2.0"
        xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/nom-domain-2.0
        nom-domain-2.0.xsd">
        <domain:name>example1.co.uk</domain:name>
        <domain:account>
         <domain:account-id>1000</domain:account-id>
        </domain:account>
        <domain:recur-bill>th</domain:recur-bill>
       </domain:create>
     </create>
     <clTRID>ABC-12345</clTRID>
   </command>
 </epp>

Response to registering a domain and creating a new account

This is an example of a successful create response where an account object was created as part of the operation:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0
      epp-1.0.xsd">
   <response>
    <result code="1000">
      <msg>Command completed successfully</msg>    
    </result>
    <resData>
     <domain:creData
      xmlns:domain="http://www.nominet.org.uk/epp/xml/nom-domain-2.0"
      xmlns:account="http://www.nominet.org.uk/epp/xml/nom-account-2.0"
      xmlns:contact="http://www.nominet.org.uk/epp/xml/nom-contact-2.0"
      xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/nom-domain-2.0
      nom-domain-2.0.xsd">
      <domain:name>example.co.uk</domain:name>
      <domain:account>
       <account:creData>
         <account:roid>100029-UK</account:roid>
         <account:name>Mr R. Strant</account:name>
       </account:creData>
      </domain:account>
      <domain:crDate>2005-10-14T13:40:50</domain:crDate>
      <domain:exDate>2007-10-14T13:40:50</domain:exDate>
     </domain:creData>
    </resData>
    <trID>
      <clTRID>ABC-12345</clTRID>
      <svTRID>102497</svTRID>
    </trID>
   </response>
 </epp>

Notes:

1. In accordance with the EPP RFC 4930, object identifiers are globally unique - this is achieved by appending the IANA administered identifier '-UK' to the registry identifier. This suffix may be included when using the identifier in requests but is not mandatory.

Response to registering a domain onto an existing account

This is an example of a successful create response where no objects (other than the domain name) were created as part of the operation:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0
      epp-1.0.xsd">
  <response>
    <result code="1000">
      <msg>Command completed successfully</msg>
    </result>
    <resData>
      <domain:creData
       xmlns:domain="http://www.nominet.org.uk/epp/xml/nom-domain-2.0"
       xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/nom-domain-2.0
       nom-domain-2.0.xsd">
        <domain:name>example1.co.uk</domain:name>
        <domain:crDate>2005-10-14T13:30:48</domain:crDate>
        <domain:exDate>2007-10-14T13:30:48</domain:exDate>
      </domain:creData>
    </resData>
    <trID>
      <clTRID>ABC-12345</clTRID>
      <svTRID>102493</svTRID>
    </trID>
  </response>
 </epp>