POST - Create a new Folder in the account


The API adds the specified folder to the particular account.  

 Request URL<accountId>/folders

 Request Parameters

ParameterData TypeDescription
accountID*IntegeraccountID - The unique Zoho Account Identifier under which a new folder should be created

* - Mandatory parameters

  Request Body (JSON Object)

ParameterData TypeAllowed ValuesDescription


 String A folder name with Alphabets/ Letters without any special character

 Specify the unique name of the folder, which should be created in the particular account. 

parentFolderIdLongThe Folder ID of the Parent Folder, under which the new folder should be created

Provide the folder ID of the parent folder, under which the new folder should be created. 

* - Mandatory parameters

Response Codes

Please refer Response Codes.

Sample Request

   "parentFolderId": 9000000009001,
   "folderName": "newCustomFolder"

Sample Response

   "status": {
      "code": 201,
      "description": "Created"
   "data": {
      "path": "/newCustomFolder",
      "folderName": "newCustomFolder",
      "folderType": "Inbox",
      "isArchived": 0,
      "imapAccess": true,
      "URI": "",
      "folderId": 9000000252001,
      "previousFolderId": 9000000009001