# createacct

### Create Account

This is to create an eenos hosting account. You can also create a hosting account with reseller privileges.

#### Required Parameters  


<p class="callout warning">These parameters are mandatory, or else you will receive 400 error code.</p>

<table border="1" id="bkmrk-filed-description-ex" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 21.0119%;"></col><col style="width: 45.6124%;"></col><col style="width: 33.3739%;"></col></colgroup><tbody><tr><td class="align-center">**Field**</td><td class="align-center">**Description**</td><td class="align-center">**Example**</td></tr><tr><td>apiuser</td><td>API user name</td><td>eenos\_api</td></tr><tr><td>apiauth</td><td>API user password</td><td>eenos123</td></tr><tr><td>domain</td><td>Client's main website name</td><td>myclientsite.com</td></tr><tr><td>user</td><td>A user name for eenos account</td><td>myclient</td></tr><tr><td>email</td><td>Contact email address of the client</td><td>contact@myclientsite.com</td></tr><tr><td>package</td><td>Hosting plan or package name</td><td>Bronze</td></tr></tbody></table>

#### Optional Parameters

<table border="1" id="bkmrk-filed-description-ex-0" style="border-collapse: collapse; width: 100%; height: 783px;"><colgroup><col style="width: 18.542%;"></col><col style="width: 70.5755%;"></col><col style="width: 10.877%;"></col></colgroup><tbody><tr style="height: 29.7612px;"><td class="align-center" style="height: 29.7612px;">**Field**</td><td class="align-center" style="height: 29.7612px;">**Description**</td><td class="align-center" style="height: 29.7612px;">**Example**</td></tr><tr style="height: 29.7612px;"><td style="height: 29.7612px;">password</td><td style="height: 29.7612px;">A password for Eenos login will be auto-generated if not given</td><td style="height: 29.7612px;">changeme</td></tr><tr style="height: 29.7612px;"><td style="height: 29.7612px;">language</td><td style="height: 29.7612px;">The language code for the eenos control panel, default is 'en'</td><td style="height: 29.7612px;">en</td></tr><tr style="height: 29.7612px;"><td style="height: 29.7612px;">theme</td><td style="height: 29.7612px;">If you have a custom theme name, the default theme is 'default'</td><td style="height: 29.7612px;">default</td></tr><tr style="height: 29.7612px;"><td style="height: 29.7612px;">mailserver</td><td style="height: 29.7612px;">Use local or remote mail server, default 'local'</td><td style="height: 29.7612px;">local</td></tr><tr style="height: 29.7612px;"><td style="height: 29.7612px;">dkim</td><td style="height: 29.7612px;"> To enable dkim, values accepted 'off' or 'on'</td><td style="height: 29.7612px;">off</td></tr><tr style="height: 29.7612px;"><td style="height: 29.7612px;">spf</td><td style="height: 29.7612px;">To enable spf, values accepted 'off' or 'on'</td><td style="height: 29.7612px;">off</td></tr><tr style="height: 29.7612px;"><td style="height: 29.7612px;">reseller</td><td style="height: 29.7612px;">To make this account reseller, accepted values 'off' or 'on'</td><td style="height: 29.7612px;">on</td></tr><tr style="height: 29.7612px;"><td style="height: 29.7612px;">resellerself</td><td style="height: 29.7612px;">Self-own accounts in case of reseller, values accepted 'off' or 'on'</td><td style="height: 29.7612px;">on</td></tr><tr style="height: 29.7612px;"><td style="height: 29.7612px;">use\_registrar\_ns</td><td style="height: 29.7612px;">To use domain registrar NS records, accepted values 'off' or 'on'</td><td style="height: 29.7612px;">on</td></tr><tr style="height: 46.5373px;"><td style="height: 46.5373px;">ipv4</td><td style="height: 46.5373px;">To enable dedicated IPv4, values accepted 'off' or 'on'. This will override the package feature</td><td style="height: 46.5373px;">off</td></tr><tr style="height: 46.5373px;"><td style="height: 46.5373px;">ipv6</td><td style="height: 46.5373px;">To enable dedicated IPv6, values accepted 'off' or 'on'. This will override the package feature</td><td style="height: 46.5373px;">off</td></tr><tr style="height: 29.7612px;"><td style="height: 29.7612px;">shell</td><td style="height: 29.7612px;">To enable jailshell access, values accepted 'off' or 'on</td><td style="height: 29.7612px;">off</td></tr><tr style="height: 35.3433px;"><td style="height: 35.3433px;">reseller\_bandwidth</td><td style="height: 35.3433px;">Reseller combined bandwidth limit. Values accepted unlimited or number (MB)

</td><td style="height: 35.3433px;">unlimited</td></tr><tr style="height: 29.7463px;"><td style="height: 29.7463px;">reseller\_limt</td><td style="height: 29.7463px;">Number of accounts reseller can create, values accepted unlimited or number</td><td style="height: 29.7463px;">10</td></tr><tr style="height: 29.7463px;"><td style="height: 29.7463px;">reseller\_quota</td><td style="height: 29.7463px;">Reseller combined disk quota, values accepted unlimited or number (MB)</td><td style="height: 29.7463px;">20000</td></tr><tr style="height: 29.7463px;"><td style="height: 29.7463px;">addondomains</td><td style="height: 29.7463px;">Number of addon domains, values accepted unlimited or number</td><td style="height: 29.7463px;">unlimited</td></tr><tr style="height: 29.7463px;"><td style="height: 29.7463px;">parkeddomains</td><td style="height: 29.7463px;">limit of Domain parking, values accepted unlimited or number</td><td style="height: 29.7463px;">10</td></tr><tr style="height: 29.7463px;"><td style="height: 29.7463px;">subdomains</td><td style="height: 29.7463px;">Number of subdomains, values accepted unlimited or number</td><td style="height: 29.7463px;">100</td></tr><tr style="height: 29.7463px;"><td style="height: 29.7463px;">email\_accounts</td><td style="height: 29.7463px;">Number of email accounts, values accepted unlimited or number</td><td style="height: 29.7463px;">150</td></tr><tr style="height: 29.7463px;"><td style="height: 29.7463px;">ftp</td><td style="height: 29.7463px;">Number of ftp accounts, values accepted unlimited or number</td><td style="height: 29.7463px;">10</td></tr><tr style="height: 29.7463px;"><td style="height: 29.7463px;">sql</td><td style="height: 29.7463px;">Number of databases, values accepted unlimited or number</td><td style="height: 29.7463px;">unlimited</td></tr><tr style="height: 29.7463px;"><td style="height: 29.7463px;">bandwidth</td><td style="height: 29.7463px;">Hosting account bandwidth limit, values accepted unlimited or number (MB)</td><td style="height: 29.7463px;">50000</td></tr><tr style="height: 29.7463px;"><td style="height: 29.7463px;">quota</td><td style="height: 29.7463px;">Hosting account disk quota, values accepted unlimited or number (MB)</td><td style="height: 29.7463px;">10000</td></tr><tr style="height: 29.7463px;"><td style="height: 29.7463px;">mailquota</td><td style="height: 29.7463px;">Hosting account default email quota, values accepted unlimited or number (MB)</td><td style="height: 29.7463px;">512</td></tr></tbody></table>

#### Result Status Codes

<table border="1" id="bkmrk-status-code-descript" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 18.7029%;"></col><col style="width: 81.4189%;"></col></colgroup><tbody><tr><td class="align-center">**Status Code**</td><td class="align-center">**Description**</td></tr><tr><td>200</td><td>Success</td></tr><tr><td>500</td><td>Server Error</td></tr><tr><td>403</td><td>Forbidden, demo server</td></tr><tr><td>400</td><td>Bad data request</td></tr></tbody></table>

#### Request URL

Post url = **/createacct/**

Full URL = [https://your-host-name:5555/api/createacct/](https://your-host-name:5555/api/createacct/)

#### Curl Code

```bash
#!/bin/bash
REQUEST_URL="/createacct/"
BASE_URL="https://your-host-name:5555/api/v1"
API_URL="$BASE_URL$REQUEST_URL"
/usr/bin/curl -X POST $API_URL \
    -d "apiuser=eenos_api" \
    -d "apiauth=eenos123" \
    -d "domain=myclientsite.com" \
    -d "user=myclient" \
    -d "email=contact@myclientsite.com" \
    -d "package=Brownse"
```

#### Sample Output

```json
{'data': {'addondomains': 'unlimited',
          'bandwidth': 'unlimited',
          'contactemail': 'contact@myclientsite.com',
          'dedicatedip': {'ipv4': 'xxx.xx.xx.xxx',
                          'ipv6': '2a01:0xxx:0xxx:2xxx:0000:0000:0000:xxxx',
                          'status': 'off',
                          'status6': 'off'},
          'dkim': 'off',
          'domain': 'myclientsite.com',
          'email': 'unlimited',
          'feature': 'Default',
          'ftp': 'unlimited',
          'homedir': '/home/myclient',
          'language': 'en',
          'maillist': 'unlimited',
          'mailquota': 'unlimited',
          'mailserver': 'local',
          'nameservers': ['ns1.eenos.com', 'ns2.eenos.com'],
          'owner': 'root',
          'package': 'Brownse',
          'parkeddomains': 'unlimited',
          'quota': 'unlimited',
          'reseller': {'selfown': 'off', 'status': 'off'},
          'setuptime': '2022-12-12 07:47',
          'shell': {'shell': '/sbin/nologin', 'status': 'off'},
          'spf': 'off',
          'sql': 'unlimited',
          'subdomains': 'unlimited',
          'theme': 'default',
          'user': 'myclient'},
 'info': 'Hosting account created successfully',
 'status': 200}

```

<details id="bkmrk-python-code-%23%21%2Fusr%2Fb"><summary>Python Code</summary>

```python
#!/usr/bin/python3
import requests
from pprint import pprint
# The API request url
request_url='/createacct/'
# The server api base url
base_url='https://your-host-name:5555/api'
# Default  base url
# base_url='https://your-host-name:5555/api'
# Version specific base url
# base_url='https://your-host-name:5555/api/v1'
# The api url 
api_ulr=base_url+request_url
# The data in dictionary format
data={
    'apiuser': 'eenos_api',
    'apiauth':'eenos123',
    'domain':'myclientsite.com',
    'user':'myclient',
    'email':'contact@myclientsite.com',
    'package':'Brownse'
}
try:   
    result=requests.post(api_ulr, data = data)
    pprint(result.json())
except Exception as e:
    pprint(str(e))
    pass
```

</details><details id="bkmrk-php-code-%3C%3Fphp-%2F%2F-th"><summary>PHP Code</summary>

```php
<?php
// The API request url
$request_url='/createacct/';

// Your server API base url
$base_url='https://your-host-name:5555/api';
// Default base url
// $base_url='https://your-host-name:5555/api';
// Version specific base url
// $base_url='https://your-host-name:5555/api/v1';
// The FULL API URL
$api_url=$base_url.$request_url;
//The data you want to send via POST
$fields= [
    'apiuser'   =>  'eenos_api',
    'apiauth'   =>  'eenos123',
    'domain'    =>  'myclientsite.com',
    'user'      =>  'myclient',
    'email'     =>  'contact@myclientsite.com',
    'package'   =>  'Brownse'
];
//url-ify the data for the POST
$fields_string = http_build_query($fields);
//open connection
$ch = curl_init();
//set the url, number of POST vars, POST data
curl_setopt($ch,CURLOPT_URL, $api_url);
curl_setopt($ch,CURLOPT_POST, true);
curl_setopt($ch,CURLOPT_POSTFIELDS, $fields_string);
//So that curl_exec returns the contents of the cURL; rather than echoing it
curl_setopt($ch,CURLOPT_RETURNTRANSFER, true); 
//execute post
$result = curl_exec($ch);
//Print the json result
echo json_encode(json_decode($result), JSON_PRETTY_PRINT);
?>
```

</details>