Imports / Imap validate and get folders
Test credentials and return folders.
Route: /api/{tenant:minlength(2)}/v{version:apiVersion}/imports/imap_validate_and_get_folders
Method: POST
Authorisation: Minimum role: ADMIN
Response object
Response status: 200 (OK)
Response type: DTO_external_email_folder[]
Wrapper: DTO_response_wrap
Other response statuses: 400 (BadRequest), 403 (Forbidden)
Response body example
DTO_external_auth_imap
Name | Type | ReadOnly | Description |
---|---|---|---|
hostname | String | Hostname | |
port | Int32 | Port | |
username | String | Username | |
password | String | Password |
DTO_external_email_folder
Name | Type | ReadOnly | Description |
---|---|---|---|
mailbox | String | Mailbox | |
folder_name | String | Folder name | |
well_known_name | ENUM mailbox_folder_well_known_name | Well known name | |
count | Int32 | Count |
ENUM mailbox_folder_well_known_name
Value | Name | Description |
---|---|---|
0 | UNKNOWN | UNKNOWN |
1 | INBOX | INBOX |
2 | SENT_ITEMS | SENT_ITEMS |
3 | DELETED_ITEMS | DELETED_ITEMS |
4 | DRAFTS | DRAFTS |
5 | ARCHIVE | ARCHIVE |
6 | JUNK_SPAM_EMAIL | JUNK_SPAM_EMAIL |
7 | CLUTTER | CLUTTER |
8 | CONVERSATION_HISTORY | CONVERSATION_HISTORY |
9 | OUTBOX | OUTBOX |
10 | TRASH | TRASH |
11 | IMPORTANT | IMPORTANT |
12 | STARRED | STARRED |
13 | UNREAD | UNREAD |
14 | CATEGORY_PERSONAL | CATEGORY_PERSONAL |
15 | CATEGORY_SOCIAL | CATEGORY_SOCIAL |
16 | CATEGORY_PROMOTIONS | CATEGORY_PROMOTIONS |
17 | CATEGORY_UPDATES | CATEGORY_UPDATES |
18 | CATEGORY_FORUMS | CATEGORY_FORUMS |