Revision as of 06:11, 28 March 2014

PUT accounts/{account}/email/{domain}/usernames/{mailboxName}/mailbox

Creates or updates a mailbox for specified account and domain. The mailbox quota is determined by the E-mail domain product specification.

Request

PUT accounts/{account}/email/{domain}/usernames/{mailboxName}/mailbox

URI Parameters

account - string

domain - string

mailboxName - string

The mailbox. String should meet the regexp [a-zA-Z0-9._-]+

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

{
    "password": "{password}", 
    "master": {master},
    "quota": {quota}
    "type": {type}
}
 

Parameters

password - string

The password. Required. The password should contain at least one letter and at least one digit. It should be at least 8 characters long. It should also not begin with "pass", and should not contain the second-level domain name of the service or the username of the mailbox.

master - boolean

Describes if this is a master account.

quota - int

Quota value in MB. If not provided default quota for OpenXchange type is set

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

204 No Content

Success

400 Bad Request

The format of the request body is invalid or the username does not meet the requirements.

401 Unauthorized

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

404 Not Found

The domain name does not exist.

Examples

Trying to create mailbox without a password

Request

PUT accounts/test-account123/email/test.com/usernames/john.smith/mailbox

{"master": false}
 

Response

400 Bad Request

{"password":"Required"}
 

Trying to create mailbox with invalid quota value(less or equal to 0)

Request

PUT accounts/test-account123/email/test.com/usernames/john.smith/mailbox

{"password: "test_password1", "quota": 0}
 

Response

400 Bad Request

{"computeFault":"Quota must be greater than 0"}
 

Create mailbox

Request

PUT accounts/test-account123/email/test.com/usernames/john.smith/mailbox

{"password": "pword1234", "master": true}
 

Response

201 Created
 

Create mailbox with specified quota

Request

PUT accounts/test-account123/email/test.com/usernames/john.smith/mailbox

{"password": "pword1234", "quota": 70}
 

Response

201 Created
 

Update existing mailbox quota

Request

PUT accounts/test-account123/email/test.com/usernames/john.smith/mailbox

{"quota": 85}
 

Response

204 No Content
 

See also

• Email API