Purpose
The API retrieves all the folders details for the specified account based on the account ID provided in the Request.
Request URL
https://mail.zoho.com/api/accounts/<accountId>/folders
Request Parameters
| Parameter | Data Type | Description |
| accountID* | Integer | accountID - The unique Identifier for a specific account of an user. |
* - Mandatory parameter
Response Codes
Please refer Response Codes.
Also refer to Folders API for more folder options.
Sample Response
Copied{
"status": {
"code": 200,
"description": "success"
},
"data": [
{
"URI": "http://mail.zoho.com/api/accounts/9999000000293/folders/9999000000305",
"path": "/Inbox",
"imapAccess": true,
"folderType": "Inbox",
"folderName": "Inbox",
"folderId": 9999000000305
},
{
"URI": "http://mail.zoho.com/api/accounts/9999000000293/folders/9999000000307",
"path": "/Drafts",
"imapAccess": true,
"folderType": "Drafts",
"folderName": "Drafts",
"folderId": 9999000000307,
"previousFolderId": 9999000000305
},
{
"URI": "http://mail.zoho.com/api/accounts/9999000000293/folders/9999000000309",
"path": "/Templates",
"imapAccess": true,
"folderType": "Templates",
"folderName": "Templates",
"folderId": 9999000000309,
"previousFolderId": 9999000000307
},
{
"URI": "http://mail.zoho.com/api/accounts/9999000000293/folders/9999000000311",
"path": "/Sent",
"imapAccess": true,
"folderType": "Sent",
"folderName": "Sent",
"folderId": 9999000000311,
"previousFolderId": 9999000000309
},
{
"URI": "http://mail.zoho.com/api/accounts/9999000000293/folders/9999000000313",
"path": "/Spam",
"imapAccess": true,
"folderType": "Spam",
"folderName": "Spam",
"folderId": 9999000000313,
"previousFolderId": 9999000000311
},
{
"URI": "http://mail.zoho.com/api/accounts/9999000000293/folders/9999000000315",
"path": "/Trash",
"imapAccess": true,
"folderType": "Trash",
"folderName": "Trash",
"folderId": 9999000000315,
"previousFolderId": 9999000000313
},
{
"URI": "http://mail.zoho.com/api/accounts/9999000000293/folders/9999000000317",
"path": "/Outbox",
"imapAccess": true,
"folderType": "Outbox",
"folderName": "Outbox",
"folderId": 9999000000317,
"previousFolderId": 9999000000315
},
{
"URI": "http://mail.zoho.com/api/accounts/9999000000293/folders/9999000009001",
"path": "/testFolder1",
"imapAccess": true,
"folderType": "Inbox",
"folderName": "MyCustomFolder",
"folderId": 9999000009001,
"previousFolderId": 9999000000317
}
]
}