The purpose of this API is to create a task in Zoho Connect.
Request URL: | https://connect.zoho.com/pulse/api/addTask |
OAuth Scope: | zohopulse.tasks.CREATE |
Request Method: | POST |
Mandatory Header: | Header name: Authorization Header Value: Zoho-oauthtoken d92d401c803988c5cb849d0b4215f52 |
Parameters
Name | Description | Required |
scopeID | Network in which the task is to be posted. Can be taken from the network list API. | Required |
boardId | In case the task needs to be added to a board, specify the board ID. If not, the task is added as a private task. | Optional |
title | Task title. Maximum characters allowed is 5000. | Required |
desc | Task description. Maximum characters allowed is 500. | Optional |
sectionId | In case the task is added to a Board, provide the ID of the section to add the task to. | Required (if added to a board) |
priority | Set the priority levels as either: None or Low or Medium or High | Required |
streamId | In case you want to add a task that refers to a post, provide the stream ID of that post.
| Optional |
position | Required in case of a board task. | Required (if added to a board) |
fileIds | Multiple file IDs should be separated by a comma. Upload files using upload files API and then use the file IDs. The user can add up to 10 files to a task. | Optional |
userIds | User IDs of members whom the task should be assigned to. Separate multiple IDs by a comma. | Optional |
eyear | Due date of the task. Mention the year. ex) 2019 | Optional |
emonth | Due date of the task. Mention the month. ex) 08 | Optional |
edate | Due date of the task. Mention the date. ex) 21 | Optional |
isSelfReminder | If the task requires a reminder set this as true. If not, set this as false. | Optional |
remYear | Task Reminder Year ex) 2019 | Optional |
remMonth | Task Reminder Month ex) 08 | Optional |
remDay | Task Reminder Day ex) 21 | Optional |
remHour | Task Reminder Hour. Mention this in the 24hr time format ex) 20 | Optional |
remMin | Task Reminder Minute. ex) 18 | Optional |
checkList | Maximum of 10 checklist items is allowed. The total number of characters in a checklist can go up to 200. | Optional |
tagNames | Names of hashtags associated with the task. Multiple tag names should be separated by a comma. | Optional |
tagColors | Differentiate tags by adding colors. Add multiple color names separated by a comma. | Optional |
frequency | Set a value if you'd like to repeat the task. Allowed values: 0,1,2,3 {0 - Daily, 1 - Weekly, 2 - Monthly, 3 - Yearly} | Optional |
howOftenRepetition | Set a value based on how often you'd like the task to be repeated. Values allowed: 1 to 30. The default value will be taken as 1. | Optional |
dayOfWeek | Used when the task is repeated WEEKLY. Allowed values: 1,2,3,4,5,6,7 {1 - Sunday to 7 - Saturday} If you'd like the task to be repeated on multiple days during the week, then add the values, separated by a comma. | Optional |
dayOfMonth | Allowed values 1 to 31. Used when the task is repeated MONTHLY. | Optional |
monthOfYear | Allowed values 1 to 11. Used when the task is repeated. Values allowed: 0 - January to 11 - December | Optional |
repeatEndYear | End year for task repetition. ex) 2019 | Optional |
repeatEndMonth | End month for task repetition. ex) 11 | Optional |
repeatEndDate | End date for task repetition. ex) 21 | Optional |
Sample URL
Copiedhttps://connect.zoho.com/pulse/api/addTask?scopeID=929000000015001&boardId=929000000471010&title=Task+for+march&eyear=2018&emonth=03&edate=18&priority=None§ionId=929000000471012&position=7
Sample Response
Copied{
"addTask": {
"stream": {
"id": "929000000855665",
"userDetails": {
"zuid": "2060758",
"id": "2060758",
"name": "Patricia Boyle",
"canFollow": "true"
},
"partition": {
"id": "929000000471010",
"name": "Zillum Marketing",
"partitionUrl": "zillum-marketing",
"url": "zillum-marketing",
"status": "ACTIVE",
"isAdmin": "true",
"type": "PROJECT",
"typeOrd": "5",
"isUserFollow": "false"
},
"allowFooter": "true",
"isApproved": "true",
"isSpam": "false",
"type": "TASK",
"nativeUrl": "/nativeTask?streamId=929000000855665&scopeID=929000000015001",
"streamId": "929000000855665",
"task": {
"title": [
{
"text": "Task for march"
}
],
"id": "929000000855663",
"percentage": "0",
"status": "0",
"priority": "None",
"createdTime": "1521527634741",
"formattedCreatedTime": "07:33 PM",
"endDateLong": "1521417599000",
"formattedDueDate": "18 Mar",
"isOverDue": "true",
"dueDateYear": "2018",
"dueDateMonth": "3",
"dueDateDay": "18",
"streamId": "929000000855665",
"canEdit": "true",
"canUpdateStatus": "true",
"canComplete": "true",
"canAssign": "true",
"canDelete": "true",
"position": "7",
"section": {
"name": "Open",
"id": "929000000471012"
},
"partition": {
"id": "929000000471010",
"name": "Zillum Marketing",
"partitionUrl": "zillum-marketing",
"url": "zillum-marketing",
"status": "ACTIVE",
"isAdmin": "true",
"type": "PROJECT",
"typeOrd": "5",
"isUserFollow": "false"
},
"userDetails": {
"zuid": "2060758",
"id": "2060758",
"name": "Patricia Boyle",
"canFollow": "true"
},
"canAddRepetition": "true"
},
"content": [
{
"text": " "
}
],
"time": "1521527634833",
"streamModifiedTime": "1521527636518",
"formatedTime": "07:33 PM",
"lastActivityTime": "1521527634833",
"canHide": "true",
"tags": [],
"comments": [
{
"id": "929000000855674",
"time": "1521527636518",
"formatedTime": "07:33 PM",
"isApproved": "true",
"commentType": "CREATED_TASK",
"canLike": "false",
"canComment": "false",
"bot": {
"items": {
"*^$@_USERNAME_*^$@_2060758": {
"zuid": "2060758",
"id": "2060758",
"name": "Patricia Boyle",
"canFollow": "true"
}
},
"img": "https://css.zohostatic.com/pulse/v_197/images/BotDefault.png",
"msg": "*^$@_USERNAME_*^$@_2060758 has created the task."
},
"userDetails": {
"zuid": "-1",
"id": "-1",
"name": "Connect Bot"
},
"content": [
{
"text": "Patricia Boyle has created the task."
}
]
}
],
"url": "https://connect.zoho.com/portal/zillum/stream/929000000855665"
}
}
}