Get a Specific Folder

Purpose

This API is used to retrieve a specific folder in a specific account, using the account ID and the folder ID.

OAuth Scope

Use the scope

ZohoMail.folders.ALL (or) ZohoMail.folders.READ

to generate the Authtoken.

ALL - Full access to folders.

READ - Read all folder details.

Request URL

Method: GET

https://mail.zoho.com/api/accounts/{accountId}/folders/{folderId}

Path Parameters

  • accountId* long
    • This key is used to identify the account from which the folders have to be fetched. It is generated during account addition.
    • This parameter can be fetched from Get all accounts API.
  • folderId* long
    • This key is used to identify the folder to be fetched.
    • This parameter can be fetched from Get all folders API.

 

* - Mandatory parameter

Response Codes

Refer here for the response codes and their meaning.

Sample Request

Copiedcurl "https://mail.zoho.com/api/accounts/25606360000****8002/folders/2560636000000075001" \
-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": "/again",
        "previousFolderId": "2560636000000008028",
        "isArchived": 0,
        "folderName": "again",
        "imapAccess": true,
        "folderType": "Inbox",
        "URI": "https://mail.zoho.com/api/accounts/25606360000****8002/folders/2560636000000075001",
        "folderId": "2560636000000075001"
    }
}