Create a new subaccount.


Use this command to create a new retail subaccount.

CreateAccount differs from CreateSubAccount in that CreateAccount offers credit card processing.

When you pass credit card information with this command, you must use the secure HTTPS protocol.


All resellers have access to this command.

Implementation on

At the bottom of the information form, the submit button calls the CreateAccount command.


The query must meet the following requirements:

  • Parameter values submitted in the query must pass validation tests.

Input parameters

Build the query string using this syntax:


Parameter Status Description Max Size
UID Required Account login ID 20
PW Required Account password 20
NewUID Required Subaccount login ID. Permitted values are 6 to 20 characters in length; permitted characters include letters, numbers, hyphen, and underscore 20
NewPW Required Subaccount password. Permitted characters are letters, numbers, hyphen, and underscore 20
ConfirmPW Required Confirm subaccount password. Permitted characters are letters, numbers, hyphen, and underscore 20
RegistrantOrganizationName Required Registrant organization 60
RegistrantJobTitle Optional Registrant job title 60
RegistrantFirstName Required Registrant first name 60
RegistrantLastName Required Registrant last name 60
RegistrantAddress1 Required Registrant address 60
RegistrantAddress2 Optional Registrant additional address info 60
RegistrantCity Required Registrant city 60
RegistrantPostalCode Required Registrant postal code 16
RegistrantStateProvince Optional Registrant state or province 60
RegistrantStateProvinceChoice Optional Registrant state or province choice: S state P province 1
RegistrantCountry Optional Registrant country 60
RegistrantPhone Required Registrant phone number. Required format is +CountryCode.PhoneNumber, where CountryCode and PhoneNumber use only numeric characters and the + is URL-encoded as a plus sign (%2B). 17
RegistrantFax Optional Registrant fax number. Required format is +CountryCode.PhoneNumber, where CountryCode and PhoneNumber use only numeric characters and the + is URL-encoded as a plus sign (%2B). 17
RegistrantEmailAddress Required Email address for Whois 128
RegistrantEmailAddress_Contact Optional Email address for us to contact you about your domain name account 128
CardType Required Type of credit card. Permitted values are Visa, Mastercard, AmEx, Discover.
When you pass credit card information with this command, you must use the secure HTTPS protocol.
CCName Required Cardholder's name 60
CreditCardNumber Required Customer's credit card number 128
CreditCardExpMonth Required Credit card expiration month in MM format 2
CreditCardExpYear Required Credit card expiration year in YYYY format 4
CVV2 Required Credit card verification code 4
CCAddress Required Credit card billing address 60
CCZip Required Credit card billing postal code 15
CCCountry Required Credit card billing country. The two-letter country code is a permitted format. 60
AuthQuestionType Required Nature of the question used for identity verification. Permitted values are:
smaiden mother’s maiden name
sbirth city of birth
ssocial last 4 digits of SSN
shigh high school
fteach favorite teacher
fvspot favorite vacation spot
fpet favorite pet
fmovie favorite movie
fbook favorite book
AuthQuestionAnswer Required The answer to the question type (mother's maiden name, city of birth, last 4 digits of social security, or high school) 50
EmailInfo Optional The value of a send e-mail notification checkbox. If EmailInfo=checked an email will be sent to the registrant email parameter posted with this request containing this account information 10
ResponseType Optional Format of response. Permitted values are Text (default), HTML, or XML. 4


Returned parameters and values

Parameter Description
OrganizationName Organization name of the Billing contact
FName First name (given name) of the Billing contact
LName Last name (family name) of the Billing contact
JobTitle Job title for the Billing contact
Address1 Address, line 1, for the Billing contact
Address2 Address, line 2, for the Billing contact
City City for the Billing contact
StateProvince State or province for the Billing contact
StateProvinceChoice Tells whether StateProvince value is a state or a province
PostalCode Postal code for the Billing contact
Country County for the Billing contact
Phone Phone number for the Billing contact
PhoneExt Phone extension for the Billing contact
Fax Fax number for the Billing contact
EmailAddress Email address for public WhoIs record
EmailAddress_Contact Email address that we use when contacting account owner about this account
EmailInfo Tells whether confirmation emails should be sent to these email addresses
CCType Type of credit card
CCName Cardholder’s name
CCNumber Credit card number
CCMonth Expiration month for this credit card
CCYear Expiration year for this credit card
CCAddress Billing address street address for this credit card
CCCity Billing address city for this credit card
CCStateProvince Billing address state or province for this credit card
CCZip Billing address postal code for this credit card
CCCountry Billing address country for this credit card
CCPhone Phone number on record for this credit card
Reseller 1 indicates this subaccount is a reseller account; 0 indicates retail
NewUID Login ID for this subaccount
NewPW Password for this subaccount
ConfirmPW Repeat password, for confirmation purposes
AuthQuestionType Type of authorization question for this subaccount
AuthQuestionAnswer Answer to the authorization question
DefPeriod Default registration period for domain names, in years
StatusCustomerInfo Returns Successful if the subaccount was created
PartyID Party ID of this subaccount, for our records
Account Account ID code of this subaccount, for our records. We recommend that you store this value.
sLoginPass Code we use to log the user into the new subaccount immediately.
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.



  • 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.
  • If there are errors validating the data passed in, the same parameters and values are returned to rebuild the form.