--- title: Create account description: Creates a new vPanel user account --- import { Callout, Tabs, Cards, Table } from "nextra/components"; import { XCircle, Key, CornerDownLeft, UserX } from "react-feather"; import { JsonOnly, XmlOnly } from "@/components/ApiSwitcher"; import { GreenText } from "@/components/Text"; # Create account This endpoint creates a new vPanel user account with the provided information. ## HTTP Endpoint
{/* prettier-ignore */}


    ```console copy filename="URL"
    https://panel.myownfreehost.net/json-api/createacct.php
    ```

{/* prettier-ignore */}


    ```console copy filename="URL"
    https://panel.myownfreehost.net/xml-api/createacct.php
    ```

## Parameters `domain` can also be a subdomain.
Parameter Required Type `username` Yes string `password` Yes string `contactemail` Yes string `domain` Yes string `plan` Yes string

## Usage ```bash copy showLineNumbers filename="Shell" curl -X POST -u username:password -d "username=example&password=password&contactemail=example@example.com&domain=subdomain.example.com&plan=MyAwesomePlan" "https://panel.myownfreehost.net/json-api/createacct.php" ``` ```python copy showLineNumbers filename="Python" import requests from requests.auth import HTTPBasicAuth url = "https://panel.myownfreehost.net/json-api/createacct.php" data = {'username': 'example', 'password': 'password', 'contactemail': 'example@example.com', 'domain': 'subdomain.example.com', 'plan': 'MyAwesomePlan'} # If you want to use a domain which is not a subdomain, put that domain in. response = requests.post(url, params=data, auth=HTTPBasicAuth('username', 'password')) print(response.json()) # Do this if you only want to get the username. print(response.json()["result"][0]["options"]["vpusername"]) # Do this if you only want to get the status code. print(response.json()["result"][0]["status"]) ``` ```bash copy showLineNumbers filename="Shell" curl -X POST -u username:password -d "username=example&password=password&contactemail=example@example.com&domain=subdomain.example.com&plan=MyAwesomePlan" "https://panel.myownfreehost.net/xml-api/createacct.php" ``` ```python copy showLineNumbers filename="Python" import requests from requests.auth import HTTPBasicAuth from xml.etree.ElementTree import fromstring, ElementTree # Do this if you only want to get the username. url = "https://panel.myownfreehost.net/xml-api/createacct.php" data = {'username': 'example', 'password': 'password', 'contactemail': 'example@example.com', 'domain': 'subdomain.example.com', 'plan': 'MyAwesomePlan'} # If you want to use a domain which is not a subdomain, put that domain in. response = requests.post(url, params=data, auth=HTTPBasicAuth('username', 'password')) print(response.text) # Do this if you only want to get the username. tree = ElementTree(fromstring(response.content)) root = tree.getroot() for child in root: print(child[0][1].text) # The vPanel and FTP username ``` ## Response ```json copy showLineNumbers filename="Response" { "result": [ { "options": { "vpusername": "hname_12345678", "nameserverentry3": null, "nameservera": null, "nameserver4": "ns4.byet.org", "ip": "n", "nameservera4": null, "nameserver": "ns1.byet.org", "package": "package_name", "nameserver2": "ns2.byet.org", "nameservera2": null, "nameserverentry4": null, "nameservera3": "ns3.byet.org", "nameserverentry2": null, "nameserverentry": null, "nameserver3": "ns3.byet.org", "nameserver5": "ns5.byet.org" }, "statusmsg": "Account Creation Ok", "rawout": "Account Creation Ok", "status": 1 } ] } ``` ```xml copy filename="Response" n hname_12345678 ns1.byet.org ns2.byet.org account added to queue to be added 1 This account has been successfuly created ``` --- ### Related pages: } title="Remove account" href="/accounts/remove" /> } title="Errors" href="/errors" /> } title="Authentication" href="/authentication" />
} title="Hosting account callbacks: account activation" href="/callbacks/hostingAccount#account-activation" />