Contacts


Definition

Update contact information for a domain name.

Usage

Use this command to set or change contact information for a domain.

If you want to update one contact type and leave the others as is, use this command with the ContactType parameter.

When you create contacts for .eu and .be domain names, we recommend that you always provide Registrant contact information that is separate from Billing contact information; don’t use the "same as Billing" default. Tip: If the Billing and Registrant contact information are the same, we recommend changing the use or spelling of abbreviations in the street address to help our system recognize that it needs to create multiple contacts. Separating the Registrant and Billing information makes it easier to update Registrant contact information in the future.

Availability

All resellers have access to this command.

Implementation on eNom.com

Log on to resellertest.enom.com with Login ID resellid, password resellpw.

https://resellertest.enom.com/domains/control-panel/default.asp?DomainNameID=152533676

On the edit contact info page, typing information in the text boxes provides the parameter values for the Contacts command.

Constraints

The query must meet the following requirements:

  • The domain must exist in the account that is modifying it.
  • Some country code TLDs require extended attributes (parameters that are specific to the country code). To find out whether a country code TLD requires extended parameters and what they are, run GetExtAttributes on the country code.
  • The BILLING contact type cannot be updated with this command. To update billing information, use UpdateAccountInfo.
  • If you use the ContactType parameter, you can reset only one contact type.
  • If you use the ContactType parameter, the contact type of the other parameters must match it (for example, if you set ContactType=AUXBILLING, you must use parameters
  • AuxBillingOrganizationName, AuxBillingFirstName, and so on.
  • If you don’t use the ContactType parameter and don’t supply new information for all contacts, those that you don’t supply will be empty in the database and will use our defaults in interfaces.

Input parameters

Build the query string using this syntax:

https://resellertest.enom.com/interface.asp?
command=nameofcommand&uid=yourloginid
&pw=yourpassword&paramname=paramvalue
&nextparamname=nextparamvalue

 

Parameter Status Description Max Size
UID Required Account login ID 20
PW Required Account password 20
SLD Required Second-level domain name (for example, enom in enom.com) 63
TLD Required Top-level domain name (extension) 15
ContactType Optional If no contact parameters are supplied, all contacts are set to the Account Billing contact Type of contact to add/update. Options are REGISTRANT, AUXBILLING, TECH, ADMIN 16
ContactTypeFirstName Required contact type you add or update First name of ContactType. In place of ContactType in the parameter name, substitute Registrant, AuxBilling, Tech, or Admin. For example, to add or update the Registrant, use RegistrantFirstName=John. 60
ContactTypeLastName Required contact type you add or update Last name of ContactType contact 60
ContactTypeOrganizationName Required contact type you add or update Organization of ContactType contact 60
ContactTypeJobTitle Optional Job title of ContactType contact 60
ContactTypeAddress1 Required contact type you add or update Address of ContactType contact 60
ContactTypeAddress2 Optional Additional address info of ContactType contact 60
ContactTypeCity Required contact type you add or update City of ContactType contact 60
ContactTypeStateProvinceChoice Optional State or province choice of ContactType contact. Permitted values are: S State P Province 1
ContactTypeStateProvince Optional State or province of ContactType contact 60
ContactTypePostalCode Optional for most TLDs; Required for .org Postal code of ContactType contact 16
ContactTypeCountry Required contact type you add or update Country of ContactType contact 60
ContactTypeEmailAddress Required for each contact type you add or update Email address of ContactType contact 128
ContactTypePhone Required contact type you add or update Phone number of ContactType contact. Required format is +CountryCode.PhoneNumber, where CountryCode and PhoneNumber use only numeric characters and the + is URL-encoded as a plus sign (%2B). 17
ContactTypePhoneExt Optional for each contact type you add or update Phone extension of ContactType contact 17
ContactTypeFax Optional Fax number of ContactType contact. Required format is +CountryCode.PhoneNumber, where CountryCode and PhoneNumber use only numeric characters and the + is URL-encoded as a plus sign (%2B). 17
ExtendedAttributes Required country codes Data required by the Registry for some country codes. Use GetExtAttributes whether this TLD requires extended attributes. varies ?
ResponseType Optional Format of response. Permitted values are Text (default), HTML, or XML. 4

 

Returned parameters and values

Parameter Description
Command Name of command executed
ErrCount The number of errors if any occurred. If greater than 0 check the Err(1 to ErrCount) values.
ErrX Error messages explaining the failure. These can be presented as is back to the client.
Done True indicates this entire response has reached you successfully.

 

Notes

  • The BILLING contact type cannot be updated with this command. To update billing information, use UpdateAccountInfo.
  • You can submit multiple contact data in a single request by omitting the ContactType parameter and sending additional contact data by replacing Registrant in the above optional parameters with the ContactTypes AUXBILLING, TECH, or ADMIN.
  • If you use the ContactType parameter, you can reset only one contact type.
  • If you use the ContactType parameter, the contact type of the other parameters must match it (for example, if you set ContactType=AUXBILLING, you must use parameters AuxBillingOrganizationName, AuxBillingFirstName, and so on).
  • If you don’t use the ContactType parameter and don’t supply new information for all contacts, those that you don’t supply will be empty in the database and will use our defaults in interfaces.
  • AUXBILLING masks the true billing contact in WhoIs output.
  • Some country code TLDs require extended attributes (parameters that are specific to the country code). To find out whether a country code TLD requires extended parameters and what they are, run GetExtAttributes on the country code.
  • The default response format is plain text. To receive the response in HTML or XML format, send ResponseType=HTML or ResponseType=XML in your request.
  • Check the return parameter ErrCount. If greater than 0 the transaction failed. The parameter Err(ErrCount) can be presented to the client. Otherwise process the returned parameters as defined above.

Example