Create a time tracking entry

Creates a time tracking entry on a given task.

Returns the record of the newly created time tracking entry.

Access requirements

Access to this endpoint has two levels:

  • Endpoint access requires time tracking to be available through the domain's plan
    or add-ons. A request from a domain without time tracking access returns a
    402 Payment Required error for every request to this endpoint.

  • Field access for some request fields requires the Timesheets and Budgets add-on.
    Fields with this requirement are noted in the request schema. Including one of these
    fields without the add-on returns a 402 Payment Required error, even when the rest of
    the request is valid.

Because the field-level requirement is separate, the same endpoint may return 201 or
402 for the same domain depending on which fields are sent: a request that only uses
fields available with endpoint access succeeds on any domain that meets the endpoint
requirement, while a request that includes a field requiring the add-on also requires
the add-on.

Path Params
string
required

The task to operate on.

Query Params
opt_fields
array of strings

This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.

opt_fields
boolean

Provides “pretty” output.
Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.

Body Params

Information about the time tracking entry.

data
object
Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json