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