This API will create user accounts under your reseller account.
- Authentication token:
The reseller’s authentication token to authorize use of the APIs this must be passed as type string. - Name:
Full name of the user as type string. - Email:
Registration email for user as type string. - Password (optional):
User’s registration password, as type string, and the password should not be less than 6 characters or more than 32 characters. If you do not set a password, an email will be sent to the customer to set their account password. - Plan ID:
The plan you wish to assign the user to. You will need to create plans on the reseller system prior using this option and pass the ID number as an integer. - Send Email:
By default, this value is set to true, as it will send an email to the user notifying the user that they are signed up to the service and the account credentials. If you wish not to send an email, set this value as Boolean false. - Language
Passed as integer, if this value is not passed, the default language will be set as English. Currently, you
can pass the following languages:
Value Language 1 English 3 French 4 Turkish
The following are the return values of the CreateAccount API.
| Code | Message | Comments |
|---|---|---|
| 1000 | The Account has been created successfully | Action successful |
| 1001 | Missing Main Parameters (name) | The full name is missing |
| 1001 | Missing Main Parameters (email) | The email is missing |
| 1002 | Invalid Authentication Token | The authentication token is incorrect, please check it and try again |
| 1003 | Invalid Email, Please send a valid email address | Make sure that the email address is in its correct format; example someone@company.com |
| 1004 | Invalid Password, Minimum 6 characters | Make sure that the password is between 6-32 characters |
| 1005 | Used Email, Someone already has that email | This email is already used by an existing Zoolz user |
| 1006 | The specified plan id does not exist | The plan id is invalid |
| 1006 | The specified plan id does not belong to this authentication token | The plan ID is not associated to your reseller account |
| 1006 | In order to add a business account, you’ll need to purchase business accounts | You will need to purchase a business account via upgrade in the reseller console to proceed |
| 1006 | In order to add a business account with instant storage, you’ll need to purchase instant storage | You will need to purchase a instant storage via upgrade in the reseller console to proceed |
| 1007 | Insert User Error DB | Unexpected database error, if this error occurs, try again later |
| 1007 | General Error, Unhandled Exception | If you receive this error, please contact support |
| 1007 | General Exception | If you receive this error, please contact support |
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced
with actual values:
POST /Services/Reseller/Service.asmx HTTP/1.1
Host: www.zoolz.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
SOAPAction: “Zoolz/UpgradeAccount”<?xml version=”1.0″ encoding=”utf-8″?>
<soap12:Envelope xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”
xmlns:xsd=”http://www.w3.org/2001/XMLSchema”
xmlns:soap12=”http://www.w3.org/2003/05/soap-envelope”>
<soap12:Body>
<UpgradeAccount xmlns=”Zoolz”>
<authToken>string</authToken>
<email>string</email>
<planID>int</planID>
</UpgradeAccount>
</soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length<?xml version=”1.0″ encoding=”utf-8″?>
<soap12:Envelope xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”
xmlns:xsd=”http://www.w3.org/2001/XMLSchema”
xmlns:soap12=”http://www.w3.org/2003/05/soap-envelope”>
<soap12:Body>
<UpgradeAccountResponse xmlns=”Zoolz”>
<UpgradeAccountResult>
<Code>Success or MissingParameters or InvalidAuth or InvalidEmail or
InvalidPassword or UsedEmail or PlanError or GeneralError</Code>
<Message>string</Message>
</UpgradeAccountResult>
</UpgradeAccountResponse>
</soap12:Body>
</soap12:Envelope>