Create call
POST {{baseUrl}}/v1/calls
This API adds a call entry to your help desk portal.
OAuth Scope
Desk.activities.calls.CREATEDesk.activities.CREATEDesk.calls.CREATE
Attributes
| Attribute Name | Data Type | Description |
|---|---|---|
| customFields | <list> | User-defined fields related to the call |
| cf | <list> | User-defined fields related to the call |
| departmentId (required) | <long> | ID of the department associated with the call and ticket |
| subject (required) | <string> max chars : 300 | Subject of the call |
| startTime (required) | <timestamp> | Time when the call started. The value of this key must be recorded in the ISO date format of yyyy-MM-ddThh:mm:ss.SSSZ. |
| direction (required) | <string> max chars : 100 | Direction of the call: inbound or outbound |
| duration (required) | <integer> | Duration of the call in seconds |
| status (required) | <string> max chars : 120 | Completion status of the call |
| ownerId | <long> | ID of the user to whom the call is assigned |
| priority | <string> max chars : 120 | Priority of the call |
| description | <string> max chars : 65535 | Description of the call |
| ticketId | <long> | ID of the ticket associated with the call |
| contactId (required) | <long> | ID of the contact associated with the call |
| reminder | <JSONArray> | Details of the reminder associated with the call |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Authorization | string |
RESPONSES
status: OK
{"cf":{},"contactId":"1892000000088017","subject":"New Testing Call","departmentId":"3000000007043","creatorId":"3000000008692","description":null,"ownerId":null,"priority":"High","duration":"300","webUrl":"https://desk.zoho.com/support/zylker/ShowHomePage.do#Calls/dv/51123033fe97b2f886f750280ded9c40","createdTime":"2016-07-14T08:27:26.000Z","startTime":"2016-07-25T16:52:11.000Z","id":"3000000054002","ticketId":"3000000008753","direction":"inbound","status":"In Progress"}