POST - Add group Task

Purpose

This API is used to add a new task to the specified group.

Request URL 

https://mail.zoho.com/api/tasks/groups/<GroupID>

Request Parameters

ParameterData TypeDescription
GroupID* IntegerThe unique identifier used for groups in the organization

* - Mandatory parameters

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
dueDateRemindersEnabledBooleanfor enabled state - true
for disabled state - false
Whether reminders on the date when the task is due is enabled or disabled
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
remindOwnerBooleanto remind owner - true
to disable reminder for owner - false
If the task owner needs to reminded
remindAssigneeBooleanto remind assignee - true
to disable reminder for assignee - false
If the member to whom the task is assigned needs to be reminded
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- 
followersJSON Array-The members who need to follow this task
lockInvitesBooleanto lock invite - true
to unlock invite - false
If the permission to invite members has to be enabled or disabled
allowCommentsBooleanto allow comments - true
to disallow comments - false
If comments for the task can be allowed or not
senderidEmail Addresssender name@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)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


				https://mail.zoho.com/api/tasks/groups/53658048

Sample Input:

{
  "title" : “Blog Updates”,
  "description" : “Revamp update blog and announcements”,
  "priority" : "high",
  "reminderDate" : "2018-03-28T17:47:40+05:30",
  "emailReminder" : "true",
  "assignee" : "54161899",
  "recurringType" : "Monthly",
  "dueDate" : "29/08/2018",
  "recurMonthlyOnDayOfMonth" : "1",
  "recurringFrequency"  : "2",
  "followers" : ["54938724"],
  "lockInvites" : "true",
  "allowComments" : "false",
  "projectId" : "48184000000005003",
  "accountId" : "48019000000005001",
  "messageId" : "48019000000032001"
} 			

Sample Response


				{
    "status": {
        "code": 200,
        "description": "success"
    },
    "data": {
        "owner": {
            "name": "Rebecca",
            "id": 54136518
        },
        "numberOfSubtasks": 0,
        "modifiedTime": "2018-03-28T17:13:40+05:30",
        "attachments": [],
        "reminder": {
            "dateTime": "2018-03-28T17:47:40+05:30",
            "emailReminder": true,
            "popupReminder": false
        },
        "subtasks": [],
        "recurring": {
            "recurMonthlyOnDayOfMonth": 1,
            "type": "Monthly",
            "frequency": 2
        },
        "dueDate": "29/08/2018",
        "description": "Make the announcement ready for the recent revamp",
        "project": {
            "name": "Blogging",
            "id": "48184000000005003"
        },
        "title": "Blog Updates",
        "priority": "High",
        "tags": [],
        "createdAt": "2018-03-28T17:13:40+05:30",
        "followers": [
            {
                "name": "Justin Case",
                "id": 54224987,
                "group": true
            },
            {
                "name": "Marketing",
                "id": 54938724
            }
        ],
        "namespaceId": "54224987",
        "id": "48184000000093001",
        "assignee": {
            "name": "Paula M",
            "id": 54161899
        },
        "status": "In Progress"
    }
}