Skip to content

Create

Purpose⚓

Create a Contact Object.

Authority⚓

A Create Contact Request can be submitted by any AR.

Result⚓

Valid request is processed immediately.

A Contact Object will be created under the management of the AR submitting the request.

A Handle will be automatically allocated to the Contact Object by the API Server, and will be included in the response sent by the API Server.

Code Example⚓

<?xml version="1.0" encoding="UTF-8"?>
<epp>
  <command>
    <create>
      <contact:create>
        <contact:postalInfo type="int">
          <contact:name>Israel Israeli</contact:name>
          <contact:org>Some Company Ltd.</contact:org>
          <contact:addr>
            <contact:street>7 Herzl St.</contact:street>
            <contact:city>Ramat Gan</contact:city>
            <contact:sp></contact:sp>
            <contact:pc></contact:pc>
            <contact:cc>IL</contact:cc>
          </contact:addr>
        </contact:postalInfo>
        <contact:voice>+972 8 1111111</contact:voice>
        <contact:fax>+972 8 2222222</contact:fax>
        <contact:email>[email protected]</contact:email>
      </contact:create>
    </create>
    <extension>
      <isocil:ext>
        <isocil:create>
          <isocil:contact>
            <isocil:type>domain</isocil:type>
          </isocil:contact>
        </isocil:create>
      </isocil:ext>
    </extension>
    <clTRID>AB-5</clTRID>
  </command>
</epp>

Legend⚓

  • <contact:create>: Defines that the desired Registration Action, create a Contact Object, where:
    • <contact:postalinfo>: Contact's postal information.
    • <contact:name>: Contains the Contact's full name. In case of a person, name and surname separated by a space. In case of legal-entity, e.g, a company, the company's full name, including appropriate suffix, e.g., "Ltd." – separated by spaces.
    • <contact:org>: Contains the Contact's organization, only(!) for domain contact type.
    • <contact:addr>: A block containing the postal information associated with the Contact:
      • <contact:street>: Contains the street and number of the Contact's address.
      • <contact:city>: Contact's city.
      • <contact:sp>: Contact's State/Province.
      • <contact:pc>: Contact's postal code.
      • <contact:cc>: Contact's two-letter country code, according to ISO-3166.
    • <contact:voice>: Contact's telephone number, in the following format: "+[country code] [area code] [phone number]"
    • <contact:fax>: Contact's facsimile number, in the following format: "+[country code] [area code] [phone number]"
    • <contact:email>: Contact's direct mail address.
  • <isocil:ext>: Defines the IL Extension Block. The whole block as appears in example MUST be a part of the Request.
  • <clTRID>: AR's transaction identifier.

Tags occurrence table⚓

Tag Occurrences
(MIN-MAX)		 Size + Remarks
<epp> 1
<command> 1
<create> 1
<contact:create> 1
<contact:name> 1 For domain contact type, name must contain at least 2 words, the first 2 of which must start with an English letter
<contact:org> 1 For domain contact type only. Total length may not exceed 100 characters. First character must be either a letter or a number. Last character must be a letter, number, space or one of these ./"(). Every character in between can be letter, number, space or one of these #@,./&"()-
<contact:addr> 1
<contact:street> 1 Mandatory. Total length may not exceed 255 characters. First character must be either a letter or a number. Last character must be a letter, number, space or one of these ./"(). Every character in between can be letter, number, space or one of these #@,./&"()-
<contact:city> 1 Mandatory. Total length may not exceed 100 characters. First character must be a letter. The following characters can be letters, space or one of these .,"'/-. The last character may not be hyphen or comma (- and ,).
<contact:sp> 1
<contact:pc> 1 If country code is IL, the postal code must be 5 or 7 digits long, and only digits - must consist of at least 2 different digits. Otherwise, must be a string 2-15 characters long, with letters, numbers, space or dashes.
<contact:cc> 1 Must be a valid Alpha-2 country code (in accordance with ISO 3166)
<contact:voice> 1 Must be digits and spaces. Must start wih +. Must be split into 3 parts, seperated by spaces (country code, area code, phone number). Max length: Country code - 3; area code - 5; phone - 12. If country code is 972 (IL), area number length max is 2 ('151' & '153' area codes are also viable). 18 characters max.
<contact:fax> 1 Same rules as <contact:voice>
<contact:email> 1 Can't be empty for domain or holder contact types.
<extension> 1
<isocil:ext> 1
<isocil:create> 1
<isocil:contact> 1
<isocil:type> 1
<clTRID> 1 Must start with 2 capital letters representing the registrar, followed by a hyphen (-) and a string of numbers. Must be unique per request. Total length may not exceed 30 characters.

Additional Response Data ( block) – in a SUCCESS message⚓

The API Server's response upon the successful completion of a Create Contact Request:

<?xml version="1.0" encoding="UTF-8"?>
<epp>
    <response>
        <result>
            <code>1000</code>
            <msg>Command completed successfully (contact requestid=C82)</msg>
        </result>
        <resData>
            <contact:creData>
                <contact:id>SS-AM11639-IL</contact:id>
                <contact:crDate>2005-10-31T11:25:00.000Z</contact:crDate>
            </contact:creData>
        </resData>
        <trID>
            <clTRID>SS-5</clTRID>
            <svTRID>ISOCIL-SS37 20051031112800</svTRID>
        </trID>
    </response>
</epp>

Legend - SUCCESS message response⚓

  • <contact:creData>: Information on the creation of the Contact Object, where:
    • <contact:id>: Specifies the Contact's Handle.
    • <contact:creDate>: Specifies the creation time of the Contact Object, in XML dateTime format.