http://docs.hostway.com/index.php?action=history&feed=atom&title=Accounts-accountId-users%3APOSTAccounts-accountId-users:POST - Revision history2026-05-04T17:42:43ZRevision history for this page on the wikiMediaWiki 1.18.0http://docs.hostway.com/index.php?title=Accounts-accountId-users:POST&diff=1127&oldid=prevMike.robski: 1 revision: Release 902014-01-31T18:23:37Z<p>1 revision: Release 90</p>
<table class='diff diff-contentalign-left'>
<tr valign='top'>
<td colspan='1' style="background-color: white; color:black;">← Older revision</td>
<td colspan='1' style="background-color: white; color:black;">Revision as of 18:23, 31 January 2014</td>
</tr></table>Mike.robskihttp://docs.hostway.com/index.php?title=Accounts-accountId-users:POST&diff=1126&oldid=prevDinh.anh: /* Parameters */2013-11-14T15:20:57Z<p><span class="autocomment">Parameters</span></p>
<p><b>New page</b></p><div>= POST /accounts/{accountId}/users =<br />
Create a new user under an account<br />
__TOC__<br />
<br />
== Request ==<br />
<code>POST /accounts/{accountId}/users</code><br />
<br />
==== Request Parameters ====<br />
;accountId<br />
: The ID of the account<br />
<br />
=== URI Parameters ===<br />
None<br />
<br />
=== Request Headers ===<br />
{{Authorization}}<br />
<br />
=== Request Body ===<br />
<nowiki><br />
{<br />
"userName": "{userName}",<br />
"password": "{password}",<br />
"securityQuestion": "{securityQuestionCode}",<br />
"securityAnswer": "{securityAnswer}"<br />
}<br />
</nowiki><br />
<br />
==== Parameters ====<br />
;userName<br />
: ''Required.'' A name for the user that's about to be created. This needs to be unique within the entire security realm (not just within the account).<br />
;password<br />
: ''Required.'' A password for the user. This needs to be between 8 and 50 characters long inclusive, must contain at least one alpha ''and'' at least one numeric character, and must not contain any of the following characters: & ` ' " \ / < > $<br />
;securityQuestionCode<br />
: ''Required.'' The reference code for a question that the user can use to recover the password in case (s)he forgot it. This must be selected from a pre-approved list of questions.<br />
;securityAnswer<br />
: ''Required.'' An answer to the security question. If the user provides the correct answer during password recovery, the password will be reset and (s)he will be allowed to access the account. The API will automatically normalize the security answer by removing starting and ending spaces, lowercase the security answer and replace each sequence of whitespaces with just one single space character.<br />
<br />
== Response ==<br />
<br />
=== Status Code ===<br />
;201 Created<br />
: The user was successfully created<br />
;400 Bad Request<br />
: The request body was missing a required field or one of the fields did not comply with the requirements (in this case, the response body will contain hints for what went wrong)<br />
;401 Unauthorized<br />
: Authentication failed<br />
;403 Forbidden<br />
: Authentication succeeded, but the logged-in user is not allowed to create users in this account. The only users allowed to create users in this account are sales agents and account owners of ''this'' account. An account owner is any account user with the "sitecontrol_account_owner" role.<br />
;404 Not Found<br />
: The account does not exist<br />
;409 Conflict<br />
: The user cannot be created because another user exists with the same username.<br />
<br />
=== Response Headers ===<br />
;Location<br />
: The URI for the newly created user<br />
<br />
=== Response Body ===<br />
None<br />
<br />
== Allowed Security Questions ==<br />
<br />
TBD<br />
<br />
== See also ==<br />
* [[Account|Account Management API]]<br />
* [[Common Features]]<br />
<br />
{{disqus}}<br />
[[Category:Hostway API]]<br />
[[Category:Account Management API]]</div>Dinh.anh