Skip to product menu
Skip to main content

Empty Folder

Purpose

This API helps to delete all the emails in the specified folder.

OAuth Scope

Use the scope

ZohoMail.folders.ALL (or) ZohoMail.folders.UPDATE

to generate the Authtoken.

ALL - Full access to folders.

UPDATE -  Delete all emails in a folder.

Request URL

Method: PUT

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

Path Parameters

  • accountId* long
    • This key identifies the account from which the folder has to be fetched. It is generated during account addition.
    • This parameter can be retrieved from Get all accounts API.
  • folderId* long
    • This key identifies the folder from which all emails need to be deleted.
    • This parameter can be retrieved from Get all folders API.

Request Body(JSON Object)

  • mode* string
    • This parameter specifies the type of operation that is to be performed.
    • Provide the value as emptyFolder.

 

* - Mandatory parameter

Response Codes

Refer here for the response codes and their meaning.

Sample Request

Copiedcurl "https://mail.zoho.com/api/accounts/N****C0CM/folders/2******008001" \
-X PUT \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization:Zoho-oauthtoken *****" \
-d '{
    "mode":"emptyFolder"
}'