Create task
POST {{baseUrl}}/api/v1/tasks
This API creates a task in your help desk portal.
OAuth Scope
Desk.activities.CREATEDesk.activities.tasks.CREATEDesk.tasks.CREATE
Attributes
| Attribute Name | Data Type | Description |
|---|---|---|
| customFields | <list> | User-defined fields related to the task |
| cf | <list> | User-defined fields related to the task |
| departmentId (required) | <long> | ID of the department in which the task must be created |
| subject (required) | <string> max chars : 300 | Subject of the task |
| ticketId | <long> | ID of the ticket with which the task must be associated |
| dueDate | <timestamp> | Due date for completing the task |
| ownerId | <long> | ID of the user to whom the task is assigned |
| category | <string> max chars : 120 | Category of the task |
| status | <string> max chars : 120 | Status of task completion |
| priority | <string> max chars : 120 | Priority of the task |
| description | <string> max chars : 65535 | Description of the task |
| contactId | <long> | ID of the contact associated with the task |
| reminder | <JSONArray> | Details of the reminder set for the task |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Authorization | string |
RESPONSES
status: OK
{"modifiedTime":"2016-07-14T09:14:41.000Z","cf":{},"subject":"Bug Fix #120","departmentId":"3000000007043","dueDate":"2016-07-21T16:16:16.000Z","creatorId":"3000000008692","description":null,"ownerId":null,"priority":"High","webUrl":"https://desk.zoho.com/support/zylker/ShowHomePage.do#Tasks/dv/51123033fe97b2f886f750280ded9c40","createdTime":"2016-07-14T08:27:26.000Z","modifiedBy":{"firstName":"George","lastName":"McKinson","photoURL":null,"id":"5000000015911"},"id":"3000000054002","isSpam":false,"category":"null","ticketId":"3000000008753","status":"In Progress"}