Delete an Email
Purpose
This API is used to delete an email.
OAuth Scope
Use the scope
ZohoMail.messages.ALL (or) ZohoMail.messages.DELETE
to generate the Authtoken.
ALL - Grants full access to messages.
DELETE - Grants access to delete messages.
Request URL
Method: DELETE
https://mail.zoho.com/api/accounts/{accountId}/folders/{folderId}/messages/{messageId}
Path Parameters
- accountId* long
- This parameter is used to identify the specific account to fetch details.
- This parameter can be retrieved from the Get User Account Details API.
- folderId* long
- This parameter is used to identify the specific folder for which the emails need to be retrieved.
- This parameter can be retrieved from the Get All Folders API.
- messageId* long
- This parameter is the unique ID associated with the particular email.
- This parameter can be retrieved from List Emails API.
Query Parameters
- expunge boolean
- This parameter specifies whether the email should be deleted permanently without moving it to the trash folder.
- Allowed values :
- true - The email will be deleted permanently without moving it to the trash folder.
- false - The email will be moved to the trash folder.
- Default value : false.
* - Mandatory parameter
Response Codes
Refer here for the response codes and their meaning.
Sample Request
Copiedcurl "https://mail.zoho.com/api/accounts/12345678/folders/9000000002014/messages/1710915488416100000" \
-X DELETE \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization:Zoho-oauthtoken *****"Sample Request
Copied{
"status": {
"code": 200,
"description": "success"
},
"data": {
"cId": 1711540991815100000
}
}