Get a Specific Folder

Purpose 

This API is used to retrieve a specific folder created in or imported to the mailbox, using folder ID.

OAuth Scope

Use the scope

MailApps.folders.ALL (or) MailApps.folders.READ

ALL - Full access to folders.

READ - Fetch a folder.

To generate Authtoken, refer here.

Request URL

Method: GET

https://mail360.zoho.com/api/accounts/{account_key}/folders/{folderId}

Path Parameters

  • account_key* string
    • This key is used to identify the mailbox from which the data has to be fetched. It is generated during account addition.
    • This parameter can be fetched from Get all accounts API.
  • folderId* long
    • This parameter refers to the ID of the folder which needs to be retrieved.
    • This parameter can be fetched from Get all folders API.

 

 

* - Mandatory parameter

Sample request

Copiedcurl "https://mail360.zoho.com/api/accounts/N7***C0CM/folders/23567***005" \
-X GET \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization:Zoho-oauthtoken ***" \

Sample Response

Copied{
   "status": {
       "code": 200,
       "description": "success"
   },
   "data": {
       "path": "/Label_3361509959031163224",
       "previousFolderId": "27684000000003001",
       "folderName": "Label_3361509959031163224",
       "folderType": "Inbox",
       "folderId": "27684000000003005"
   }
}