POST - Add new personal Task

Purpose

This API is used to add a new personal task.

Request URL 

https://mail.zoho.com/api/tasks/me

Request Body (JSON Object)

ParameterData TypeAllowed ValuesDescription
Title*String-The title for the task that is being added
DescriptionString-The task description
StatusStringinprogress (or) completedThe status of completion of the task
PriorityStringhigh (or) medium (or) lowThe priority to be given for the task
projectIdLong-The unique identifer assigned to each project created for group tasks
parentTaskIdLong-The unique identifier given for the parent task
dueDateDatedd/mm/yyyyThe due date that you want to set for the task
reminderDateDatedd/mm/yyyyThe date when you want to be reminded about the task
emailReminderBooleanto enable reminder - true
to disable reminder - false
If reminders need to be sent via email
popupReminderBooleanto enable reminder - true
to disable reminder - false
If reminder notifications need be sent
Assignee*Longzuid of the userThe zuid of the member to whom the task is assigned
subtaskJSON Object-The details of the subtask that has to be added as a task
accountIdLong- 
messageIdLong- 
senderidEmail Addresssendername@domainname.com 
Recurring typeStringDaily (or) Weekly (or) Monthly (or) YearlyThe recurrence pattern for the task
recurringFrequencyInteger-The frequency at which the task has to recur
recurFromDatedd/mm/yyyyThe date from which recurrence has to start
recurUntilDatedd/mm/yyyyThe date until which the task has to recur
recurForInteger-The number of times the task has to recur
recurDailyOnlyOnWeekdaysBooleantrue; falseIf the task has to recur everyday in the weekdays
recurWeeklyOnInteger1-7 (1 denotes Sunday and 7 denotes Saturday)The day of the week when the task has to recur every week
recurMonthlyOnDayOfWeekInMonthIntegerAny date of the monthThe day of the week in a particular month when the task has to recur every month
recurMonthlyOnDayOfMonthIntegerAny date of the monthThe day of the month when the task has to recur every month
recurMonthlyOnDayOfWeekIntegerDays of the week (Sunday, Monday, etc.)The day of the week when the task has to recur every month
recurYearlyOnDayOfWeekInMonthIntegerEx: 3 indicates the 3rd week of the monthThe day of the week in a particular month when the task has to recur every year
recurYearlyOnDayOfMonthIntegerAny date of the monthThe date of the month when the task has to recur every year
recurYearlyOnDayOfWeekIntegerDays of the week (Sunday, Monday, etc.)The day of the week when the task has to recur every year
recurYearlyOnMonthInteger0-11 (0 - January, 1 - February, etc.)The month when the task has to recur for that year
attachStoreNameJSON Array-The StoreName for the uploaded attachment
attachPathJSON Array-The path specified for the uploaded attachment

* - Mandatory parameters

Note:

Use this API to get the attachStoreName and attachPath parameter values.

The 'recurMonthlyOnDayOfWeekInMonth' and 'recurMonthlyOnDayOfWeek' parameters should be used together. The 'recurYearlyOnDayOfMonth' and the 'recurYearlyOnMonth' parameters should be used together. Similarly, the 'recurYearlyOnDayOfWeek' and the 'recurYearlyOnMonth' parameters should be used together.

Response Codes

Please refer Response Codes.

Sample Request


				Sample URL:

https://mail.zoho.com/api/tasks/me?

Sample Input:

{
 "title": “Blog Updates”,
 "description": “Announcement blog for recent revamp“,
 "priority":"low"
}			

Sample Response


				{
"status":
  {
     "code":200,"description":"success"
  },
"data":
  {
    "owner":
    {
     "name":"Rebecca",
     "id":4650081
    },
    "numberOfSubtasks":0,
    "modifiedTime":"2017-07-07T01:20:39+05:30",
    "attachments":[],
    "subtasks":[],
    "description":"Announcement about the recent updates",
    "project":                  
 {
         "name":"Blogging",
         "id":"7000000006001"
         },
       "title":"Blog Updates",
       "priority":"low",
       "tags":[],
       "createdAt":"2017-07-07T01:20:39+05:30",
       "followers":[],
       "namespaceId":"4650081",
       "id":"7000000089009",
       "assignee":
         {
          "name":"Rebecca",
          "id":4650081
         },
      "status":"In Progress"
 }
}