---
title: "Create cPanel account"
method: GET
path: "/createacct"
tags: ["Account Creation"]
---

# Create cPanel account

`GET /createacct`

This function creates a cPanel account and sets up its domain information.

**Note:**

* On servers that run CentOS 7, you may see a `named` warning about the absence of SPF resource records on DNS.
* This warning is **not** relevant on CentOS 7 servers, because [RFC 7208 deprecated SPF records](https://tools.ietf.org/html/rfc7208). CentOS 7 servers use TXT records instead of SPF records.
* Red Hat 7.1 and CentOS 7.1 both contain `bind-9.9.4-23.el7`, which is an updated version of BIND that complies with RFC 7208. To resolve this issue, update your operating system to a version that contains the updated version of BIND. For more information, read the [Red Hat Bugzilla case about SPF record errors](https://bugzilla.redhat.com/show_bug.cgi?id=1215164).

## Query parameters

- `username` string, required
- `account_enhancements` union
  - string
  - string[]
- `bwlimit` union
  - unknown
  - 'unlimited', megabytes
  - integer
- `cgi` 1 | 0
- `contactemail` string, email
- `cpmod` string
- `customip` string, ipv4
- `dkim` 0 | 1
- `dmarc` 0 | 1
- `domain` string
- `featurelist` string
- `forcedns` 0 | 1
- `frontpage` integer, nullable
- `gid` integer
- `hasshell` 0 | 1
- `hasuseregns` 0 | 1
- `homedir` string
- `ip` 'y' | 'n'
- `language` string
- `mail_node_alias` string
- `mailbox_format` 'mdbox' | 'maildir'
- `max_defer_fail_percentage` union
  - 'unlimited'
  - integer
- `max_email_per_hour` union
  - 'unlimited'
  - integer
- `max_emailacct_quota` union
  - 'unlimited', megabytes
  - integer
- `max_team_users` integer
- `maxaddon` union
  - unknown
  - 'unlimited'
  - integer
- `maxftp` union
  - unknown
  - 'unlimited'
  - integer
- `maxlst` union
  - unknown
  - 'unlimited'
  - integer
- `maxpark` union
  - unknown
  - 'unlimited'
  - integer
- `maxpop` union
  - unknown
  - 'unlimited'
  - integer
- `maxsql` union
  - unknown
  - 'unlimited'
  - integer
- `maxsub` union
  - unknown
  - 'unlimited'
  - integer
- `mxcheck` 'local' | 'secondary' | 'remote' | 'auto'
- `owner` string
- `ownerself` 0 | 1
- `pass` string
- `password` string
- `pkgname` string
- `plan` string
- `quota` integer
- `reseller` 0 | 1
- `reseller_without_domain` 0 | 1
- `savepkg` 0 | 1
- `showpass` 'y' | 'n'
- `spamassassin` 0 | 1
- `spambox` 'y' | 'n'
- `spf` 0 | 1
- `uid` integer
- `useregns` 0 | 1

## Response `200`

HTTP Request was successful.

- object
  - `data` object
    - `ip` string, ipv4 — The account's primary nameserver's IP address.
    - `nameserver` string — The account's primary nameserver.
    - `nameserver2` string — The account's secondary nameserver.
    - `nameserver3` string — The account's tertiary nameserver.
    - `nameserver4` string — The account's quaternary nameserver.
    - `nameservera` string, ipv4, nullable — The account's primary nameservers' IP address.
    - `nameservera2` string, ipv4, nullable — The account's secondary nameservers' IP address.
    - `nameservera3` string, ipv4, nullable — The account's tertiary nameservers' IP address.
    - `nameservera4` string, ipv4, nullable — The account's quaternary nameservers' IP address.
    - `nameserverentry` string, nullable — The primary nameserver's DNS name.
    - `nameserverentry2` string, nullable — The secondary nameserver's DNS name.
    - `nameserverentry3` string, nullable — The tertiary nameserver's DNS name.
    - `nameserverentry4` string, nullable — The quaternary nameserver's DNS name.
    - `package` string — The account's plan (package) name.
  - `metadata` object
    - `command` string — The method name called.
    - `output` object — An object that contains the function's raw output information.
      - `raw` string — The raw output from the account creation operation. This return may contain HTML code.
    - `reason` string — The reason the API function failed when the `metadata.result` field is `0`. This field may display a success message when a function succeeds.
    - `result` 0 | 1 — * `1` - Success. * `0` - Failed. Check the `reason` field for more details.
    - `version` integer — The version of the API function.

---

[API](https://skmtc.net/cpanel/apis/whm-api.md) · [All operations](https://skmtc.net/cpanel/apis/whm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cpanel/whm-api/revisions/3da41671c02c/schema)