Add Ticket Time Entry

POST {{baseUrl}}/api/v1/tickets/:ticket_id/timeEntry

This API adds a time entry in your help desk

OAuth Scope

  • Desk.tickets.UPDATE

Attributes

Attribute NameData TypeDescription
requestChargeType<string>
max chars : 120
Type of request in the ticket. Values supported are Customer Service, Upgrade Request, Product Consultation, and Support and Maintenance.
ownerId<long>
ID of the user associated with the time entry
executedTime (required)<timestamp>
Time when work related to the time entry was started.
hoursSpent<integer>
Number of hours in the time entry.
minutesSpent<integer>
Number of minutes in the time entry.
secondsSpent<integer>
Number of seconds in the time entry.
agentCostPerHour<double>
Per hour cost of an agent.
additionalCost<double>
Additional cost incurred
fixedCost<double>
Fixed cost
description<string>
max chars : 65535
Description of the time entry
customFields<list>
User-defined fields related to the time entry.
cf<JSONObject>
User-defined fields related to the time entry.
mode<String>
Mode configured in time tracking. Supported values are Manual and Auto
isBillable<boolean>
Billing Preference
invoiceId<long>
ID of the invoice related to the time entry

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring

RESPONSES

status: OK

{&quot;secondsSpent&quot;:&quot;21&quot;,&quot;parent&quot;:{&quot;ticketNumber&quot;:&quot;1004&quot;,&quot;subject&quot;:&quot;Ticket subject&quot;,&quot;id&quot;:&quot;4000000031007&quot;,&quot;type&quot;:&quot;TICKETS&quot;},&quot;cf&quot;:{&quot;cf_timeentryname&quot;:&quot;time2&quot;},&quot;executedTime&quot;:&quot;2016-06-22T20:30:00.000Z&quot;,&quot;fixedCost&quot;:null,&quot;departmentId&quot;:&quot;4000000008694&quot;,&quot;minutesSpent&quot;:&quot;23&quot;,&quot;creatorId&quot;:&quot;4000000008692&quot;,&quot;agentCostPerHour&quot;:&quot;3.0&quot;,&quot;description&quot;:&quot;Time Entry description&quot;,&quot;hoursSpent&quot;:&quot;3&quot;,&quot;ownerId&quot;:&quot;4000000008692&quot;,&quot;isBillable&quot;:true,&quot;mode&quot;:&quot;MANUAL&quot;,&quot;isTrashed&quot;:&quot;false&quot;,&quot;billingType&quot;:&quot;FIXED_COST_FOR_TICKETS&quot;,&quot;createdTime&quot;:&quot;2016-06-21T05:52:00.828Z&quot;,&quot;invoiceId&quot;:&quot;4000000008688123&quot;,&quot;id&quot;:&quot;4000000045001&quot;,&quot;requestChargeType&quot;:&quot;Customer Service&quot;,&quot;additionalCost&quot;:&quot;10.0&quot;,&quot;totalCost&quot;:&quot;20.17&quot;}