Revision as of 15:24, 15 November 2013

POST /accounts/{account}/email/{domain}/usernames/{mailboxName}/webmail

Creates OpenXchange account.

Request

POST /accounts/{account}/email/{domain}/usernames/{mailboxName}/webmail

URI Parameters

account - string

domain - string

mailboxName - string

Request Headers

Authorization - HTTP Authorization header [1]

The Authentication credentials of the client application.

Content-Type

Required. Set this header to application/json; charset=UTF-8

Request Body

{
    "type": "{type}",
    "allowUpgrade": {allowUpgrade}
}
 

Parameters

allowUpgrade - boolean

OpenXchange allowUpgrade option value. The default value is true.

type - string - one of "standard", "activesync" or "premium"

OpenXchange account type. Valid values are standard, activesync, premium. If not provided - standard is default.

Response

Status Code

201 Created

Success

400 Bad Request

The format of the request body is invalid or the OpenXchange account type does not meet the requirements.

401 Unauthorized

The supplied credentials are invalid or do not provide permissions for this operation.

409 Conflict

OpenXchange account already exists.

404 Not Found

The domain name or mailbox do not exist.

Examples

Failure creating account with not-valid parameter

Request

PUT /accounts/test/email/test.com/usernames/john.smith/webmail

{"type": "non-valid"}
 

Response

400 Bad Request

{"type": "\"non-existing\" is not one of standard, activesync, premium"}
 

Success creating account

Request

POST /accounts/test/email/test.com/usernames/john.smith/webmail

{"type": "standard", "allowUpgrade": false}
 

Response

201 Created