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": "admin@example.net"
      }
    }
  },
  "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.

​
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"

⌘I