Creating a Contact
Synopsis
| Description | A command to create a new contact object |
| URL | https://toolkit.centralnic.com/srv/create_handle |
| HTTP Method | POST |
| Requires Authentication? | Yes |
| Requires SSL? | Yes |
| Query Parameters: | |
| test | The test flag (eg 1 or 0, optional) |
| user | Your Registrar ID (eg H12345) |
| password | Your Toolkit Password |
| visible | Whether to show the contact in WHOIS records (1 or 0, default is 1) |
| name | Contact Name |
| company | Contact Organisation (optional) |
| street1 | Street Address |
| street2 | Street Address (optional) |
| street3 | Street Address (optional) |
| city | City/Postal Town |
| sp | State, Province or County (optional) |
| postcode | Postal/Zip Code (optional) |
| country | Country |
| phone | Phone number (optional) |
| fax | Fax number (optional) |
| E-mail address | |
This service allows you to create a new contact object in our database. It is advisable to create a new contact when registering multiple domain names to avoid administration problems in the future. When the record has been created it can be used with new domain registrations.
Only the following parameters are mandatory: name, country, email.
The cc parameter is a two-character ISO-3166 country code.
The phone and fax fields may be in any format, but the e164a +nn.nnnnnn format is recommended.
The visible parameter is an optional field that controls whether the object's contact details are show in WHOIS records for domain names to which it is associated. A value of 0 makes the contact "invisible". The default is 1.
Legacy Parameters
Prior to September 2006, this function accepted a single handle parameter which contained contact data in double colon-separated format. While this parameter is still supported, its use is not recommended in new client code, and so is not documented here.
Response Format
Responses from the server will have the form
Transaction-ID: e2ca01ad7135e787a5e97ad5b421ed74 Status: 0 Message: Handle created OK Handle: H12345
The handle field identifies the contact created. In the event of an error, the server will return a response of the form
Transaction-ID: e2ca01ad7135e787a5e97ad5b421ed74 Status: 1 Message: Cannot create handle: missing fields (-7)