Creating a Handle
Synopsis
| Description: | A command to create a new handle 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 Handle ID |
| password | Your encrypted Registrar password |
| visible | Whether to show the handle 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 handle record in our database. It is advisable to create a new handle when registering multiple 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 handle's contact details are show in WHOIS records for domain names to which it is associated. A value of 0 makes the handle "invisible". The default is 1.
Legacy Parameters
Prior to September 2006, this function accepted a single handle parameter which contained handle 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 handle 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)