WHM API 1 - createacct

2022-10-30 09:28:19

 
 

Skip to end of metadata

 

Go to start of metadata

 

Overview

This page contains the input variables, output variables, and examples in JSON and XML output formats for the createacct function.

The createacct function creates a hosting account and sets up its associated domain information.

Note

Icon

For help on how to use this function, read the tutorial page on how to call WHM API 1 Functions.

Parameters

Input Type Description
username string

The username for the account that you wish to create (for example, username).

Note

Icon

Usernames must be eight characters or less, or, as of cPanel & WHM version 11.40, 16 characters or less if database prefixes are disabled. Also, usernames cannot start with a number, or the string test.
domain string The domain name to assign to the account (for example, example.com).
plan string The package that you wish to apply to the new account (for example, reseller_gold).
pkgname string The name of a new package to be created based on the settings used (for example, reseller_new).
savepkg boolean This value determines whether to save the settings as a new package. A value of 1 will save the settings as a new package.
featurelist string The name of the feature list to be used when you create a new package (for example, no_ftp_100mb_gold).
quota integer The disk space quota, in megabytes. Allowed values are: a number from 0 to 999999 where a value of 0 is unlimited.
password string The password that you wish to assign to the new account (for example, p@ss!w0rd$123).
ip string This value determines whether the domain has a dedicated IP address. A value of y will flag the domain for a dedicated IP address.
cgi boolean This value determines whether the domain has CGI access. A value of 1 grants the domain CGI access.
frontpage boolean

This value determines whether the domain can install FrontPage extensions. A value of 1 allows FrontPage extensions to be installed.

Note:

Icon

cPanel & WHM will ignore all Microsoft® FrontPage® settings and parameters if either of the following statements are true:

  • Your server runs cPanel & WHM version 11.44 and FrontPage extensions are not installed on your server.
  • Your server runs cPanel & WHM version 11.46 or later.
dkim (optional) boolean

This value determines whether the domain has DKIM enabled. A value of 1 enables DKIM.

Note:

Icon

This parameter does not follow the Enable DKIM on domains for newly created accounts setting in WHM'sTweak Settings interface (Home >> System Configuration >> Tweak Settings). If you wish to enable DKIM on this newly-created domain, set this parameter to a value of 1.
spf (optional) boolean

This value determines whether the domain has SPF enabled. A value of 1 enables SPF.

Note:

Icon

This parameter does not follow the Enable SPF on domains for newly created accounts setting in WHM's Tweak Settings interface (Home >> System Configuration >> Tweak Settings). If you wish to enable SPF on this newly-created domain, set this parameter to a value of 1.
hasshell boolean This value determines whether the domain has shell (SSH) access. A value of 1 grants shell access to the domain.
contactemail string Contact email address for the account (for example, user@example.com).
cpmod string

The name of the cPanel theme that is assigned to the domain (for example: x3).

Note

Icon

If no value is provided, the function will use the cPanel default theme (set in WHM in the Basic cPanel & WHM Setup interface). This behavior only applies to version 11.36+.
maxftp string The maximum number of FTP accounts that the user can create. Allowed values are: a number from 0 to 999999 where a value of 0 is unlimited, unlimited, and null.
maxsql string The maximum number of SQL databases that the user can create. Allowed values are: a number from 0 to 999999 where a value of 0 is unlimited, unlimited, and null.
maxpop string The maximum number of email accounts that the user can create. Allowed values are: a number from 0 to 999999 where a value of 0 is unlimited, unlimited, and null.
maxlst string The maximum number of mailing lists that the user can create. Allowed values are: a number from 0 to 999999 where a value of 0 is unlimited, unlimited, and null.
maxsub string The maximum number of subdomains that the user can create. Allowed values are: a number from 0 to 999999 where a value of 0 is unlimited, unlimited, and null.
maxpark string The maximum number of parked domains that the user can create. Allowed values are: a number from 0 to 999999where a value of 0 is unlimited, unlimited, and null.
maxaddon string The maximum number of addon domains that the user can create. Allowed values are: a number from 0 to 999999 where a value of 0 is unlimited, unlimited, and null.
bwlimit string The bandwidth limit, in megabytes. This value must be a number from 0 to 999999, where a value of 0 is unlimited.
customip string This value specifies an IP address for the site.
language string The language that you wish for the new account to use in the cPanel interface (for example, spanish-utf8).
useregns boolean This value determines whether the domain will use the registered nameservers for the domain instead of the ones configured on the server. A value of 1 will use the registered nameservers for the domain.
hasuseregns boolean If you set useregns to 1, you must set this value to 1.
reseller boolean This value determines whether you wish to grant reseller privileges to the account. A value of 1 will grant reseller privileges to the account.
forcedns boolean This value will overwrite an existing DNS Zone with this new account's information if one already exists. A value of 1 will overwrite an existing DNS zone with this new account's information.
mxcheck string

Determines how the server will handle incoming mail for this domain. This variable can be set to one of the following:
local — The domain will accept mail, regardless of whether a higher-priority mail exchanger has been designated on the WHM Edit MX Entry interface. (If a higher-priority mail exchanger exists, mail will be routed to both domains.)
secondary (or backup) — The domain will act as a backup mail exchanger, and it will hold mail in queue if the primary exchanger becomes unavailable.

Note

Icon

You will still need to use the WHM Edit MX Entry interface to configure the primary MX entry to point to the appropriate exchanger.

remote — The domain will not accept mail, instead sending it to the primary mail exchanger. Note: You will still need to use the WHM Edit MX Entry interface to configure the primary MX entry to point to the appropriate exchanger.
auto — The server will automatically detect, and use, the configuration set on the WHM Edit MX Entry interface.
 MAX_EMAIL_PER_HOUR integer

The maximum number of emails the account can send in an hour. This parameter's default value is unlimited. A value of0 will result in an unlimited value.

Note

Icon

This variable is only accepted in cPanel & WHM Version 11.32 and later.
 MAX_DEFER_FAIL_PERCENTAGE integer

The percentage of failed or deferred email messages the account can send per hour before outgoing mail is rate-limited. This parameter's default value is unlimited.

Note

Icon

This variable is only accepted in cPanel & WHM Version 11.32 and later.
 uid string

The user ID for a new account. This must be a numeral, not already associated with disk usage, and does not pre-exist on the machine. You must be logged in as the root user.

Note

Icon

This variable is only accepted in cPanel & WHM Version 11.32 and later.
 gid string

The group ID for a new account. This must be a numeral, not already associated with disk usage, and does not pre-exist on the machine. You must be logged in as the root user.

Note

Icon

This variable is only accepted in cPanel & WHM Version 11.34 and later.
 homedir string

The home directory (HOMEDIR) to be used for a new account. You must be logged in as the root user (for example:/home/johndoe).

Note

Icon

This variable is only accepted in cPanel & WHM Version 11.34 and later.
Output Type Description
createacct The container for the results from the createacct function.
result The container for the results of the function.
options The container for the domain options.
ip string IP address with which the the domain is associated (for example, 123.456.789.10).
nameserverX string The nameserver for the domain. The property of nameserver may be appended by an integer (x) between 1 and 5 (for example: nameserver1).
nameserveraX string IP address of the nameserver. The property of nameservera may be appended by an integer (x) between 1 and 5 (for example: nameservera1).
nameserverentryX string DNS name of the nameservers the namerservers are registered. The property of nameserverentry may appear appended by an integer (x) between 1 and 5 (for example: nameserverentry1).
rawout string Raw output of the account creation operation in HTML format.

Examples

JSON
Input URL

https://hostname:2087/cpsess########/json-api/createacct
Output
{
   "result":[
      {
         "status":1,
         "statusmsg":"Account Creation Ok",
         "rawout":"<table style=\"border- bottom: 1px #ccc dotted;\"><tr><td width=\"100%\"> <pre>Checking input data...System has 2 free ips.\n...Done</pre></td><td width=\"30\"> <img align=absmiddle src=\"/cPanel_magic_revision_1181098607/icons/good.gif\"></td> </tr></table>\n<table style=\"border-bottom: 1px #ccc dotted;\"><tr><td width=\"100%\"> <pre>WWWAcct 12.1.0 (c) 1997-2008 cPanel, Inc....\n\nDns Zone check is enabled. \n+===================================+\n| New Account Info |\n+===================================+\n| Domain: example.com\n| Ip: 127.0.0.1 (n)\n| HasCgi: y\n| UserName: user123\n| PassWord: h@rd2gu3ss!p@ss\n| CpanelMod: x3\n| HomeRoot: /home\n| Quota: 0 Meg\n| NameServer1: ns1.example.net\n| NameServer2: ns2.example.net\n| NameServer3: ns1.example.com\n| NameServer4: ns2.example.com\n| Contact Email: \n| Package: level3==\n| Feature List: default\n| Language: english\n+===================================+\n...Done</pre> </td><td width=\"30\"><img align=absmiddle src=\"/cPanel_magic_revision_1181098607/icons/good.gif\"> </td></tr></table>\n<table style=\"border-bottom: 1px #ccc dotted;\"><tr><td width=\"100%\"><pre>Running pre creation script (/scripts/prewwwacct)......Done</pre></td><td width=\"30\"><img align=absmiddlesrc=\"/cPanel_magic_revision_ 1181098607/icons/good.gif\"> </td></tr></table>\n<table style=\"border-bottom: 1px #ccc dotted;\"><tr> <td width=\"100%\"><pre>Adding User...Removing Shell Access (n)\n...Done</pre> </td><td width=\"30\"><img align=absmiddle src=\"/cPanel_magic_revision_1181098607/icons/good.gif\"> </td></tr></table>\n<table style=\"border-bottom: 1px #ccc dotted;\"> <tr><td width=\"100%\"><pre>Copying skel files from /root/cpanel3-skel/ to /home/user123/......Done</pre></td><td width=\"30\"> <img align=absmiddle src=\"/cPanel_magic_revision_1181098607/icons/good.gif\"></td></tr></table>\n<table style=\"border-bottom: 1px #ccc dotted;\"><tr><td width=\"100%\"><pre>Adding Entries to httpd.conf......Done</pre></td><td width=\"30\"><img align=absmiddle src=\"/cPanel_magic_revision_1181098607/icons/good.gif\"></td></tr></table>\n<table style=\"border-bottom: 1px #ccc dotted;\"><tr><td width=\"100%\"><pre>Setting up Mail & Local Domains...localdomains...valiases ...vdomainaliases...vfilters......Done</pre></td> <td width=\"30\"><img align=absmiddle src=\"/cPanel_magic_revision_1181098607/icons/good.gif\"></td></tr></table>\n<table style=\"border-bottom: 1px #ccc dotted;\"><tr><td width=\"100%\"><pre>Configuring DNS...Bind reconfiguring on publicdocs using rndc\n...Done</pre></td><td width=\"30\"> <img align=absmiddle src=\"/cPanel_magic_revision_1181098607/icons/good.gif\"></td></tr></table>\n<table style=\"border-bottom: 1px #ccc dotted;\"><tr><td width=\"100%\"><pre>Restarting apache......Done</pre></td><td width=\"30\"><img align=absmiddle src=\"/cPanel_magic_revision_1181098607/icons/good.gif\"></td></tr></table>\nChanging password for user123\nPassword for user123 has been changed\n<table style=\"border- bottom: 1px #ccc dotted;\"><tr><td width=\"100%\"><pre>Updating Authentication Databases...Updating ftp passwords for user123\nFtp password files updated.\nFtp vhost passwords synced\n...Done</pre></td><td width=\"30\"><img align=absmiddle src=\"/cPanel_magic_revision_1181098607/icons/good.gif\"> </td></tr></table>\n<table style=\"border-bottom: 1px #ccc dotted;\"><tr><td width=\"100%\"><pre>Verifying MX Records and Setting up Databases......Done</pre></td><td width=\"30\"><img align=absmiddle src=\"/cPanel_magic_revision_1181098607/icons/good.gif\"> </td></tr></table>\n<table style=\"border-bottom: 1px #ccc dotted;\"><tr><td width=\"100%\"><pre>Setting up Proxy Subdomains......Done</pre></td><td width=\"30\"><img align=absmiddle src=\"/cPanel_magic_revision_1181098607/icons/good.gif\"></td></tr></table>\nBind reloading on publicdocs using rndc zone: [example.com]\n<table style=\"border-bottom: 1px #ccc dotted;\"><tr><td width=\"100%\"><pre>Sending Account Information......Done</pre></td><td width=\"30\"><img align=absmiddle src=\"/cPanel_magic_revision_1181098607/icons/good.gif\"></td> </tr></table>\nSystem has 2 free ips.\n<table style=\"border-bottom: 1px #ccc dotted;\"> <tr><td width=\"100%\"><pre>Running post creation scripts (/scripts/legacypostwwwacct, /scripts/postwwwacct, /scripts/postwwwacctuser)......Done</pre></td><td width=\"30\"> <img align=absmiddle src=\"/cPanel_magic_revision_1181098607/icons/good.gif\"></td></tr> </table>\nwwwacct creation finished\n<table style=\"border-bottom: 1px #ccc dotted;\"> <tr><td width=\"100%\"><pre>Setting up Domain Pointers......Done</pre></td><td width=\"30\"> <img align=absmiddle src=\"/cPanel_magic_revision_1181098607/icons/good.gif\"></td></tr></table> \n<table style=\"border-bottom: 1px #ccc dotted;\"><tr><td width=\"100%\"> <pre>Setting Reseller Privs......Done</pre></td><td width=\"30\"><img align=absmiddle src=\"/cPanel_magic_revision_1181098607/icons/good.gif\"></td></tr></table>\n<table style=\"border-bottom: 1px #ccc dotted;\"><tr><td width=\"100%\"><pre>Account Creation Complete!!!...Account Creation Ok...Done</pre></td><td width=\"30\"><img align=absmiddle src=\"/cPanel_magic_revision_1181098607/icons/good.gif\"></td></tr></table>\n", "options":{ "nameserver4":"ns2.example.com", "nameserver":"ns1.example.net", "nameserverentry2":null, "nameserverentry3":null, "nameserverentry4":null, "nameserverentry":null, "ip":"127.0.0.1", "nameservera2":null, "nameservera3":null, "package":"level3==", "nameservera4":null, "nameserver2":"ns2.cpanelrocks.net", "nameservera":null, "nameserver3":"ns1.example.com" }
 }
 ]
}
XML
Input URL

https://hostname:2087/cpsess########/xml-api/createacct
Output
<createacct>
     <result>       
          <options>
                  <ip>192.168.0.20</ip>
                  <nameserver>ns1.domain.tld</nameserver>
                  <nameserver2>ns2.domain.tld</nameserver2>
                  <nameserver3/>
                  <nameserver4/>
                  <nameservera/>
                  <nameservera2/>
                  <nameservera3/>
                  <nameservera4/>
                  <nameserverentry/>
                  <nameserverentry2/>
                  <nameserverentry3/>
                  <nameserverentry4/>
                  <package>basic</package>
           </options>
           <rawout>
Checking input data...The ProFTPd configuration file /etc/proftpd.conf appears to be ok!
System has 0 free ips.
...Done
 
WWWAcct 12.1.0 (c) 1997-2008 cPanel, Inc....
 
Dns Zone check is enabled.
+===================================+
| New Account Info                  |
+===================================+
| Domain: domain.tld
| Ip: 192.168.0.20 (n)
| HasCgi: y
| UserName: myuser
| PassWord: h@rd2gu3ss!p@ss
| CpanelMod: x3
| HomeRoot: /home
| Quota: 0 Meg
| NameServer1: ns1.example.com
| NameServer2: ns2.example.com
| NameServer3: ns1.domain.com
| NameServer4:
| Contact Email: username@domain.tld
| Package: basic
| Feature List: default
| Language: english
+===================================+
...Done
 
Running pre creation script (/scripts/prewwwacct)......Done
Adding User...Removing Shell Access (n)
...Done
Copying skel files from /root/cpanel3-skel/ to /home/myuser/......Done
Adding Entries to httpd.conf......Done
Setting up Mail and Local Domains...localdomains...
valiases ...vdomainaliases...vfilters......Done
Configuring DNS...Bind reconfiguring on server1 using rndc
...Done
Restarting apache......Done
Changing password for myuser Password for myuser has been changed
Updating Authentication Databases...Updating ftp passwords for myuser
Ftp password files updated.
Ftp vhost passwords synced
...Done
Verifying MX Records and Setting up Databases......Done
Setting up Proxy Subdomains......Done
Bind reloading on server1 using rndc zone: [domain.tld]
Sending Account Information......Done
System has 0 free ips.
Running post creation scripts (/scripts/legacypostwwwacct,
/scripts/postwwwacct, /scripts/postwwwacctuser)......Done
wwwacct creation finished
Setting up Domain Pointers......Done
Setting Reseller Privs......Done
Account Creation Complete!!!...Account Creation Ok...Done
            </rawout>
            <status>1</status>
            <statusmsg>Account Creation Ok</statusmsg>
     </result>
</createacct>
上一篇：聊聊Docker


下一篇：FJUT第四周寒假作业[JL]最后的晚餐（动态规划）