Delete All Emails in a Folder

Purpose 

This API is used to delete emails in a folder.

OAuth Scope

Use the scope

MailApps.folders.ALL (or) MailApps.folders.UPDATE

ALL - Full access to folders.

UPDATE - Delete the emails in a folder.

To generate Authtoken, refer here.

Request URL

Method: PUT

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 where the operation has to be performed.
    • This parameter can be fetched 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.

Sample Request

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

Sample Response

Copied{
    "status": {
        "code": 200,
        "description": "success"
    }
}