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

ParameterData TypeDescription
accountID*IntegeraccountID - The unique Identifier for a specific account of an user.  

* - Mandatory parameter

 Response Codes

Please refer Response Codes.

Sample Response


				{
   "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
      }
   ]
}