Skip to main content
POST
/
core
/
v1
/
accounts
Create Account
curl --request POST \
  --url https://api.dev.name.com/core/v1/accounts \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account": {
    "accountName": "reseller_subaccount",
    "password": "SecureP4ss!",
    "contacts": {
      "registrant": {
        "firstName": "Jane",
        "lastName": "Doe",
        "address1": "123 Main St.",
        "city": "Denver",
        "state": "CO",
        "zip": "12345",
        "country": "US",
        "phone": "+13035551212",
        "email": "[email protected]"
      }
    }
  },
  "apiTos": true,
  "tos": true
}
'
{
  "accountName": "new_reseller_account",
  "apiToken": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "apiTokenName": "my_reseller_token"
}

Authorizations

​
Authorization
string
header
required

Authenticate via HTTP Basic with your account username and API token. Examples use an explicit 'Authorization: Basic <base64(username:token)>' header; 'curl -u username:token' is equivalent. For sandbox, append "-test" to your username and use your sandbox token on api.dev.name.com.

Body

application/json

CreateAccountRequest has the information that is needed to create an account with the CreateAccount function.

CreateAccountRequest has the information that is needed to create an account with the CreateAccount function.

​
account
object
required

The account details for the new account being created.

​
apiTos
boolean
required

Must be set to true to indicate acceptance of the API Terms of Service.

Example:

true

​
tos
boolean
required

Must be set to true to indicate acceptance of the general Terms of Service.

Example:

true

Response

A successful response containing the newly created account details and credentials.

CreateAccountResponse contains information about the newly created account and the API credentials generated for it.

​
accountName
string
required

AccountName is the unique user-assigned name of newly created account.

Example:

"new_reseller_account"

​
apiToken
string<password>
required

The authentication token that should be used to access the API. This value is only returned once upon account creation.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

​
apiTokenName
string
required

ApiTokenName user assigned name of api token.

Example:

"my_reseller_token"