PUT - Move Thread(s)


This API is used to move single or multiple threads.

OAuth Scope

Use the scope

ZohoMail.messages.ALL (or) ZohoMail.messages.UPDATE

to generate the Authtoken.

ALL - Full access to messages.

UPDATE - Update messages.

Request URL

Method : PUT


Path Parameters

  • accountId*long
    • This is the unique identifier for a particular user account.
    • This parameter can be fetched from User Account Details API.

Request Body (JSON Object)

  • mode* string
    • This parameter represents the type of operation that is to be performed.
    • Provide the value as moveMessage.
  • threadId* JSON Array of long values
    • This parameter should be passed as an array of single or multiple thread IDs that need to be moved.
    • threadId is a unique identifier assigned to a thread.
  • isArchive boolean
    • This parameter indicates whether the threads to be moved are archived or not.
    • The possible value can be
      • true - If the email threads are archived.
      • false - If the email threads are not archived.
  • isFolderSpecific boolean
    • This parameter specifies whether the threads to be moved are folder specific or not. 
    • The value can be
      • true - If folder specific.
      • false - If not folder specific
  • folderId string
    • This is the ID of the folder whose email threads need to be moved.
    • This is a mandatory parameter if the 'isFolderSpecific' parameter has the value 'true'.


- Mandatory parameter

Response Codes

Refer here for the response codes and their meaning.

Sample Request Body

    "mode": "moveMessage",
    "isFolderSpecific": "true",
    "folderId": "134143131",
    "threadId": [