Skip to content

Update

Purpose

Update details of an existing Contact Object.

Authority

Only the Managing AR can update Contact Objects under his management.

Scope

The Contact Object's name field CANNOT be updated with Update Contact. If the Contact's name requires modification, a new Object needs to be created, using the Create Contact Request.

Attempting to update the Contact's name field with an Update Contact Request will result in an error.

Result

Valid request is processed immediately.

The information included in the Update Contact Request will override any existing information.

IMPORTANT: all sub tags of the Contact information block must be included in the Request. Information that needs not be updated, needs to be explicitly included in the Request and contain the Contact's current data.

Code Example

<?xml version="1.0" encoding="UTF-8"?>
<epp>
  <command>
    <update>
      <contact:update>
        <contact:id>BL-BL3612-IL</contact:id>
        <contact:chg>
          <contact:postalInfo type="int">
            <contact:name>Israel Israeli</contact:name>
            <contact:addr>
              <contact:street>Moshe Levy 11</contact:street>
              <contact:city>Tel Aviv</contact:city>
              <contact:sp></contact:sp>
              <contact:pc>23489</contact:pc>
              <contact:cc>IL</contact:cc>
            </contact:addr>
          </contact:postalInfo>
          <contact:voice>+972 1 8965200</contact:voice>
          <contact:email>registrant@somemail.co.il</contact:email>
        </contact:chg>
      </contact:update>
    </update>
    <clTRID>AB-123004</clTRID>
  </command>
</epp>

Legend

  • <contact:update>: Defines that the desired Registration Action, create a Contact Object, where:
    • <contact:id>: The Handle of the Contact Object being updated.
    • <contact:postalinfo>: Contact's postal Info.
    • <contact:name>: Contains the Contact's full name. The name MUST BE IDENTICAL to the Contact's existing name. Any deviation will be interpreted as an attempt to modify the name field and will result in an error.
    • <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.
  • <clTRID>: AR's transaction identifier

Tags occurrence table

Tag Occurrences
(MIN-MAX)
Size + Remarks
<epp> 1
<command> 1
<update> 1
<contact:update> 1
<contact:id> 1 Must be an existing contact handle, belonging to the requesting AR. There are 2 viable structures: 1. XX-XX#-IL, where XX represents the 2 capital letters representing the regisrar, and # represents a string of numbers; 2. 3 characters of capital letters or hyphen, followed by numbers. Total length may not exceed 30 characters.
<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 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:sp> 1
<contact:pc> 1 If country code is IL, the postal code must be 5 or 7 digits long, and only 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 be split into 3 parts, seperated by spaces (country code, area code, phone number). Max length: Country code - 3; area code - 5; phone - 9. If country code is 972 (IL), area number length max is 2 ('151' & '153' area codes are also viable)
<contact:fax> 1
<contact:email> 1 Can't be empty for domain or holder contact types.
<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.