Accounts-account-email-domain-usernames-mailboxName-forwards:POST

(Difference between revisions)
Jump to: navigation, search
m (1 revision: Release 87)
Line 115: Line 115:
 
         {"target": "test-fwd@test.com"},
 
         {"target": "test-fwd@test.com"},
 
         {"target": "test-fwd1@test.com"}
 
         {"target": "test-fwd1@test.com"}
 +
    ]
 +
}
 +
</nowiki>
 +
 +
'''Response'''
 +
<nowiki>
 +
204 No Content
 +
</nowiki>
 +
 +
=== Setting forwarding with local storage ===
 +
In order to have local storage for forwarding, target mailboxes have to be in the same local domain as the source mailbox.<br>
 +
So the previous two examples of successful setup of forwarding are showing how to setup forwarding with local storage for respectively one and multiple target mailboxes.
 +
=== Failure setting forwarding to a single mailbox with local storage by setting the source address as the target address ===
 +
'''Request'''
 +
<nowiki>
 +
POST accounts/source_account/email/test.com/usernames/test/forwards
 +
 +
{
 +
    "targets": [
 +
        {"target": "source-account@test.com"}
 +
    ]
 +
}
 +
</nowiki>
 +
 +
'''Response'''
 +
<nowiki>
 +
400 Bad Request
 +
 +
{"source-account@test.com": "Is the same as current mailbox"}
 +
</nowiki>
 +
 +
=== Failure setting forwarding to a single mailbox with local storage by providing a non-existing target ===
 +
'''Request'''
 +
<nowiki>
 +
POST accounts/{account}/email/test.com/usernames/test/forwards
 +
 +
{
 +
    "targets": [
 +
        {"target": "not-existing-mailbox@test.com"}
 +
    ]
 +
}
 +
</nowiki>
 +
 +
'''Response'''
 +
<nowiki>
 +
400 Bad Request
 +
 +
{"not-existing-mailbox@test.com": "Target not found"}
 +
</nowiki>
 +
 +
=== Failure setting forwarding to multiple mailboxes with local storage by providing a non-existing target ===
 +
It is important to know that either '''all or none''' of the targets will be set-up for forwarding.<br>
 +
That is: a single non-existant mailbox in the targets list will prevent all of the targets from being added irrespective of it's position in the targets list.
 +
<nowiki>
 +
POST accounts/{account}/email/test.com/usernames/test/forwards
 +
 +
{
 +
    "targets": [
 +
        {"target": "existing-mailbox@test.com"},
 +
        {"target": "not-existing-mailbox@test.com"}
 +
    ]
 +
}
 +
</nowiki>
 +
 +
'''Response'''
 +
<nowiki>
 +
400 Bad Request
 +
 +
{"not-existing-mailbox@test.com": "Target not found"}
 +
</nowiki>
 +
 +
=== Success setting forwarding to a single mailbox without local storage ===
 +
Notice the '''different_domain''' in the request.<br>
 +
'''Request'''
 +
<nowiki>
 +
POST accounts/{account}/email/test.com/usernames/test/forwards
 +
 +
{
 +
    "targets": [
 +
        {"target": "test-fwd@different_domain.com"}
 +
    ]
 +
}
 +
</nowiki>
 +
 +
'''Response'''
 +
<nowiki>
 +
204 No Content
 +
</nowiki>
 +
 +
=== Success setting forwarding to multiple mailboxes without local storage ===
 +
'''Request'''<br>
 +
Notice that '''different_domain_1.com''' and '''different_domain_2.com''' are both not test.com.
 +
<nowiki>
 +
POST accounts/{account}/email/test.com/usernames/test/forwards
 +
 +
{
 +
    "targets": [
 +
        {"target": "test-fwd@different_domain_1.com"},
 +
        {"target": "test-fwd1@different_domain_2.com"}
 
     ]
 
     ]
 
}
 
}

Revision as of 09:30, 24 June 2014

POST accounts/{account}/email/{domain}/usernames/{mailbox}/forwards

Sets forwarding for specified mailbox,domain and account.

Contents


Request

POST accounts/{account}/email/{domain}/usernames/{mailbox}/forwards

URI Parameters

account - string
domain - string
mailbox - 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 

{
    "targets": [
        {"target": "{target-email}"},
        {"target": "{target-email1}"},
    ]
}


Parameters

targets - list
List of target objects.
target - string
The target mailbox to forward to.

Response

Status Code

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

Failure setting forwarding with missing required parameter

Request 

POST accounts/{account}/email/test.com/usernames/test/forwards

{empty request body}

Response 

400 Bad Request

{"targets":"Required"}


Failure setting forwarding by not providing target

Request 

POST accounts/{account}/email/test.com/usernames/test/forwards

{"targets":[]}

Response 

400 Bad Request

{"targets": "Shorter than minimum length 1"}

Success setting forwarding

Request 

POST accounts/{account}/email/test.com/usernames/test/forwards

{
    "targets": [
        {"target": "test-fwd@test.com"}
    ]
}

Response 

204 No Content


Success setting forwards

Request 

POST accounts/{account}/email/test.com/usernames/test/forwards

{
    "targets": [
        {"target": "test-fwd@test.com"},
        {"target": "test-fwd1@test.com"}
    ]
}

Response 

204 No Content

Setting forwarding with local storage

In order to have local storage for forwarding, target mailboxes have to be in the same local domain as the source mailbox.
So the previous two examples of successful setup of forwarding are showing how to setup forwarding with local storage for respectively one and multiple target mailboxes.

Failure setting forwarding to a single mailbox with local storage by setting the source address as the target address

Request 

POST accounts/source_account/email/test.com/usernames/test/forwards

{
    "targets": [
        {"target": "source-account@test.com"}
    ]
}

Response 

400 Bad Request

{"source-account@test.com": "Is the same as current mailbox"}

Failure setting forwarding to a single mailbox with local storage by providing a non-existing target

Request 

POST accounts/{account}/email/test.com/usernames/test/forwards

{
    "targets": [
        {"target": "not-existing-mailbox@test.com"}
    ]
}

Response 

400 Bad Request

{"not-existing-mailbox@test.com": "Target not found"}

Failure setting forwarding to multiple mailboxes with local storage by providing a non-existing target

It is important to know that either all or none of the targets will be set-up for forwarding.
That is: a single non-existant mailbox in the targets list will prevent all of the targets from being added irrespective of it's position in the targets list. 

POST accounts/{account}/email/test.com/usernames/test/forwards

{
    "targets": [
        {"target": "existing-mailbox@test.com"},
        {"target": "not-existing-mailbox@test.com"}
    ]
}

Response 

400 Bad Request

{"not-existing-mailbox@test.com": "Target not found"}

Success setting forwarding to a single mailbox without local storage

Notice the different_domain in the request.
Request 

POST accounts/{account}/email/test.com/usernames/test/forwards

{
    "targets": [
        {"target": "test-fwd@different_domain.com"}
    ]
}

Response 

204 No Content

Success setting forwarding to multiple mailboxes without local storage

Request
Notice that different_domain_1.com and different_domain_2.com are both not test.com. 

POST accounts/{account}/email/test.com/usernames/test/forwards

{
    "targets": [
        {"target": "test-fwd@different_domain_1.com"},
        {"target": "test-fwd1@different_domain_2.com"}
    ]
}

Response 

204 No Content

See also


blog comments powered by Disqus

Retrieved from "http://docs.hostway.com/index.php?title=Accounts-account-email-domain-usernames-mailboxName-forwards:POST&oldid=1337"
Personal tools
Namespaces
Variants
Actions
APIs
Navigation
Toolbox