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 |