Skip to Main Content

Nominet

Log in to the online service
Skip Primary Navigation
Skip All Secondary and Tertiary Navigation
  
Print this page  | Contact Us
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 account or the ID of an existing account.
  • If you create a new account then you must also supply contact details
  • Details of the nameservers or IDs of existing nameservers.
The identifiers of all 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. From 9th Sep 2008, 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 account object to be used for the domain name; or
    • an <account:create> element defining the sub-elements of a account 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 elements, each of which can be of either of the following types:
    • <ns:create> containing the sub-elements of a nameserver object to be created and used.
    • <domain:nsObj> containing the identifier of a nameserver object to be used.
  • 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>

<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.
  • If any nameserver objects were created, a <domain:ns> element. This contains <ns:creData> sub-elements describing the nameserver objects that were created. The <ns:creData> element is described below.
  • A <domain:crDate> element.
  • A <domain:exDate> element .
From 9 Sep 2008, if multiple <domain:name> elements are provided in the request, the <domain:creData> element will be repeated for each domain name.

Accounts


Accounts can only be created as part of the domain creation process.  Once an account has been created you can add domains to it by specifying the ID of the account.

<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.
  • One to six <account:contact> elements giving admin and billing contacts to be added to the account. The <account:contact> element has a type attribute that may be of value "admin" or "billing" and order attribute that may be of values "1", "2" or "3" and has a single element which is of the following type:
    • <contact:create> defining the sub-elements of the contact to be created.
  •  One or two <account:addr> elements giving the admin and billing addresses for the account. The <account:addr> has a type attribute which may be of value "admin" or "billing". The <account:addr> element has the following sub-elements defining the parts of the address:
    • <account:street>
    • <account:locality>
    • <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).
  • If any contact objects were created, an <account:contact> element with type and main attributes for each one. This contains a single <contact:creData> element giving the details of the created contact object. This sub-element is described below.

Contacts


Contacts can be created during domain name creation or update of an existing registration.

<contact:create> element

The <contact:create> element has the following sub-elements:
  • A <contact:name> element.
  • A <contact:email> element.
  • An optional <contact:phone>
  • An optional <contact:fax>
  • An optional <contact:mobile>

<contact:creData> element

The <contact:creData> element describes a contact object that has been created and contains the following sub-elements:
  • A <contact:roid> element giving the repository object identifier for the contact object.
  • A <contact:name> element giving the name of the contact object.

Nameservers



Nameservers can be created during domain name creation or update of an existing registration.

<ns:create> element

The <ns:create> element has the following sub-elements:
  • A <ns:name> element giving the name of the nameserver.
  • An optional <ns:addr> element with an ip attribute of "v4" giving the ipv4 address for the nameserver.
  • An optional <ns:addr> element with an ip attribute of "v6" giving the ipv6 address for the nameserver.

<ns:creData> element

The <ns:creData> element is returned in a response and describes the namesever object that has been created.  It contains the following sub-elements:
  • A <ns:roid> element giving the repository object identifier for the nameserver object.
  • A <ns:name> element giving the name of the nameserver.
  • A <ns:crDate> 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-1.0"
          xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/nom-domain-1.0
          nom-domain-1.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-1.0"
            xmlns:contact="http://www.nominet.org.uk/epp/xml/nom-contact-1.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 type="admin">
            <account:street>2102 High Street</account:street>
            <account:locality>Carfax</account:locality>
            <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 type="admin" order="1">
            <contact:create>
              <contact:name>Mr R. Strant</contact:name>
              <contact:phone>01865 123456</contact:phone>
              <contact:fax>01865 123456</contact:fax>
              <contact:email>r.strant@strant.co.uk</contact:email>
            </contact:create>
           </account:contact>
           <account:contact type="admin" order="2">
            <contact:create>
              <contact:name>Ms S. Strant</contact:name>
              <contact:phone>01865 123457</contact:phone>
              <contact:fax>01865 123456</contact:fax>
              <contact:email>s.strant@strant.co.uk</contact:email>
            </contact:create>
           </account:contact>
           <account:contact type="billing" order="1">
            <contact:create>
             <contact:name>A. Ccountant</contact:name>
             <contact:phone>01865 657893</contact:phone>
             <contact:email>acc@billing.co.uk</contact:email>
           </contact:create>
          </account:contact>
         </account:create>
        </domain:account>
          <domain:ns
           xmlns:ns="http://www.nominet.org.uk/epp/xml/nom-ns-1.0">
           <ns:create>
            <ns:name>ns0.example.co.uk</ns:name>
            <ns:addr ip="v4">1.2.3.4</ns:addr>
           </ns:create>
           <ns:create>
             <ns:name>ns3.example.net</ns:name>
           </ns:create>
         </domain:ns>
         <domain:recur-bill>bc</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-1.0"
             xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/nom-domain-1.0
             nom-domain-1.0.xsd">
              <domain:name>example1.co.uk</domain:name>
              <domain:account>
                <domain:account-id>1000</domain:account-id>
              </domain:account>
              <domain:ns>
               <domain:nsObj>NS1001</domain:nsObj>
               <domain:nsObj>NS1002</domain:nsObj>
             </domain:ns>
             <domain:recur-bill>bc</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-1.0"
             xmlns:account="http://www.nominet.org.uk/epp/xml/nom-account-1.0"
             xmlns:contact="http://www.nominet.org.uk/epp/xml/nom-contact-1.0"
             xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/nom-domain-1.0
             nom-domain-1.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:contact type="admin" order="1">
                <contact:creData>
                 <contact:roid>C100081-UK</contact:roid>
                 <contact:name>Mr R. Strant</contact:name>
                </contact:creData>
               </account:contact>
               <account:contact type="billing" order="1">
                <contact:creData>
                 <contact:roid>C100082-UK</contact:roid>
                 <contact:name>A. Ccountant</contact:name>
                </contact:creData>
               </account:contact>
               <account:contact type="admin" order="2">
               <contact:creData>
                <contact:roid>C100083-UK</contact:roid>
                <contact:name>Ms S. Strant</contact:name>
               </contact:creData>
              </account:contact>
             </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-1.0"
            xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/nom-domain-1.0
            nom-domain-1.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>
 
More pages
Related contacts
Contact Registrar Systems Support Telephone: 01865 332233 Email: support@nominet.org.uk Technical Blog Web: blog.nominet.org.uk/tech  
 
 
© Nominet UK 1996-2008  |  Accessibility  |  Site Map  |  Feeds