PUT - Set or Change Task Reminder

Purpose

This API is used to set or change the reminder date and the reminder type (email or notification) for a task.

OAuth Scope

Use the scope

ZohoMail.tasks.ALL (or) ZohoMail.tasks.UPDATE

to generate the Authtoken.

ALL - Full access to tasks.

UPDATE - Update the reminder date or type.

Request URL

Method: PUT

Group Task:

https://mail.zoho.com/api/tasks/groups/{zgid}/{taskId}

or

Personal Task:

https://mail.zoho.com/api/tasks/me/{taskId}

Path Parameters

  • zgid* long
    • Specifies the unique identifier used for groups in an organization.
    • This parameter can be retrieved from the Get all groups API.
  • taskId* long

Request Body ( JSON Object)

  • reminderDate* string
    • Specifies the date and time when you want to be reminded about the task.  
    • Format: ISO 8601 (e.g.:2024-01-23T12:34:56+05:30).
  • emailReminder* boolean
    • Specifies whether the reminders need to be sent via email.
    • Possible values :
      • true (enable reminder via email).
      • false (disable reminder via email).
  • popupReminder* boolean
    • Specifies whether reminder notifications need be sent.
    • Possible values :
      • true (enable reminder notification).
      • false (disable reminder notification).

 

* - Mandatory parameter

Note:

Either emailReminder or popupReminder should be set to true. Both can be true if the user wants, but at least one should be true for the reminder to be set.

Response Codes

Refer here for the response codes and their meaning.

Sample Request

CopiedGroup Task:

curl "https://mail.zoho.com/api/tasks/groups/5******048/48184******91002" \
-X PUT \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization:Zoho-oauthtoken *****"\
-d '{
"reminderDate" : "2018-10-09T02:33:50+00:00",
"emailReminder" : "false",
"popupReminder" : “true”
 }'

Personal Task:

curl "https://mail.zoho.com/api/tasks/me/4818******00091002" \
-X PUT \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization:Zoho-oauthtoken *****"\
-d '{
"reminderDate" : "2018-10-09T02:33:50+00:00",
"emailReminder" : "false",
"popupReminder" : “true”
 }'