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

(Difference between revisions)
Jump to: navigation, search
m (1 revision: Release 95)
(→Creating local forwarding or distribution list that contains mailboxes in the source domain)
Line 57: Line 57:
 
== Examples ==
 
== Examples ==
  
−
=== Failure setting forwarding with missing required parameter ===
+
=== Failure when creating a forwarding with missing required parameter ===
 
'''Request'''
 
'''Request'''
 
  <nowiki>
 
  <nowiki>
Line 72: Line 72:
 
  </nowiki>
 
  </nowiki>
  
−
 
+
=== Failure when creating a forwarding with an empty list of targets ===
−
=== Failure setting forwarding by not providing target ===
+
 
'''Request'''
 
'''Request'''
 
  <nowiki>
 
  <nowiki>
Line 88: Line 87:
 
  </nowiki>
 
  </nowiki>
  
−
=== Success setting forwarding ===
+
=== Success when creating a forwarding ===
 
'''Request'''
 
'''Request'''
 
  <nowiki>
 
  <nowiki>
Line 95: Line 94:
 
{
 
{
 
     "targets": [
 
     "targets": [
−
         {"target": "test-fwd@test.com"}
+
         {"target": "test-fwd@example.com"}
 
     ]
 
     ]
 
}
 
}
Line 105: Line 104:
 
</nowiki>
 
</nowiki>
  
−
 
+
=== Success setting multiple forwarding targets (distribution list) ===
−
=== Success setting forwards ===
+
 
'''Request'''
 
'''Request'''
 
  <nowiki>
 
  <nowiki>
Line 114: Line 112:
 
     "targets": [
 
     "targets": [
 
         {"target": "test-fwd@test.com"},
 
         {"target": "test-fwd@test.com"},
−
         {"target": "test-fwd1@test.com"}
+
         {"target": "test-fwd1@example.com"}
 
     ]
 
     ]
 
}
 
}
Line 124: Line 122:
 
</nowiki>
 
</nowiki>
  
−
=== Setting forwarding with local storage ===
+
=== Creating local forwarding or distribution list that contains mailboxes in the source domain ===
−
In order to have local storage for forwarding, target mailboxes have to be in the same local domain as the source mailbox.<br>
+
Local forwarding is created when some or all of the target mailboxes are in the same domain as the source mailbox. In case there are such mailboxes certain validation rules are applied that verify the target mailbox existence and that the target mailbox is different than the source.<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.
+
It is important to note that '''none''' of the targets will be created if the validation fails for '''any''' of the mailboxes in the list.<br/>
−
=== Failure setting forwarding to a single mailbox with local storage by setting the source address as the target address ===
+
That is: a single non-existent local target mailbox in the list will prevent all of the targets from being added regardless of the invalid target position in the list.
 +
 
 +
=== Failure when creating forwarding to the same mailbox (avoids forwarding loops) ===
 
'''Request'''
 
'''Request'''
 
  <nowiki>
 
  <nowiki>
Line 146: Line 146:
 
</nowiki>
 
</nowiki>
  
−
=== Failure setting forwarding to a single mailbox with local storage by providing a non-existing target ===
+
=== Failure when creating local forwarding to non-existing mailbox ===
 
'''Request'''
 
'''Request'''
 
  <nowiki>
 
  <nowiki>
Line 165: Line 165:
 
</nowiki>
 
</nowiki>
  
−
=== Failure setting forwarding to multiple mailboxes with local storage by providing a non-existing target ===
+
=== Failure when creating a distribution list with a missing local target mailbox ===
−
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>
 
  <nowiki>
 
POST accounts/{account}/email/test.com/usernames/test/forwards
 
POST accounts/{account}/email/test.com/usernames/test/forwards
Line 186: Line 184:
 
</nowiki>
 
</nowiki>
  
−
=== Success setting forwarding to a single mailbox without local storage ===
+
=== Success creating forwarding to an external mailbox ===
−
Notice the '''different_domain''' in the request.<br>
+
Notice the '''different_domain.com''' in the request is external (different than '''test.com''').<br>
 
'''Request'''
 
'''Request'''
 
  <nowiki>
 
  <nowiki>
Line 194: Line 192:
 
{
 
{
 
     "targets": [
 
     "targets": [
−
         {"target": "test-fwd@different_domain.com"}
+
         {"target": "test-fwd@different-domain.com"}
 
     ]
 
     ]
 
}
 
}
Line 204: Line 202:
 
</nowiki>
 
</nowiki>
  
−
=== Success setting forwarding to multiple mailboxes without local storage ===
+
=== Success creating forwarding to multiple external mailboxes (distribution list) ===
 
'''Request'''<br>
 
'''Request'''<br>
−
Notice that '''different_domain_1.com''' and '''different_domain_2.com''' are both not test.com.
+
Notice that '''different_domain_1.com''' and '''different_domain_2.com''' are both different than '''test.com'''.
 
  <nowiki>
 
  <nowiki>
 
POST accounts/{account}/email/test.com/usernames/test/forwards
 
POST accounts/{account}/email/test.com/usernames/test/forwards
Line 212: Line 210:
 
{
 
{
 
     "targets": [
 
     "targets": [
−
         {"target": "test-fwd@different_domain_1.com"},
+
         {"target": "test-fwd@different-domain_1.com"},
−
         {"target": "test-fwd1@different_domain_2.com"}
+
         {"target": "test-fwd1@different-domain_2.com"}
 
     ]
 
     ]
 
}
 
}

Revision as of 03:27, 27 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 when creating a 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 when creating a forwarding with an empty list of targets

Request 

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

{"targets":[]}

Response 

400 Bad Request

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

Success when creating a forwarding

Request 

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

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

Response 

204 No Content

Success setting multiple forwarding targets (distribution list)

Request 

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

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

Response 

204 No Content

Creating local forwarding or distribution list that contains mailboxes in the source domain

Local forwarding is created when some or all of the target mailboxes are in the same domain as the source mailbox. In case there are such mailboxes certain validation rules are applied that verify the target mailbox existence and that the target mailbox is different than the source.
It is important to note that none of the targets will be created if the validation fails for any of the mailboxes in the list.
That is: a single non-existent local target mailbox in the list will prevent all of the targets from being added regardless of the invalid target position in the list.

Failure when creating forwarding to the same mailbox (avoids forwarding loops)

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 when creating local forwarding to non-existing mailbox

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 when creating a distribution list with a missing local target mailbox 

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 creating forwarding to an external mailbox

Notice the different_domain.com in the request is external (different than test.com).
Request 

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

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

Response 

204 No Content

Success creating forwarding to multiple external mailboxes (distribution list)

Request
Notice that different_domain_1.com and different_domain_2.com are both different than 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=1554"
Personal tools
Namespaces
Variants
Actions
APIs
Navigation
Toolbox