Nothing Found

Create a time entry

Create a time entry.

Note: A time entry that has a negative duration means that timer is currently running for that user.

SecurityAuthorization Token
Request
path Parameters
team_Id
required
number <double>

Team ID (Workspace)

query Parameters
custom_task_ids
boolean

If you want to reference a task by it's custom task id, this value must be true.

team_id
number <double>

Only used when the custom_task_ids parameter is set to true.

For example: custom_task_ids=true&team_id=123.

Request Body schema: application/json

Associate a time entry with a task using the tid parameter.

description
string
Array of objects (Tags6)

Users on the Business Plan and above can include a time tracking label.

start
required
integer <int64>
stop
integer <int64>

The duration parameter can be used instead of the stop parameter.

end
integer <int64>
billable
boolean
duration
required
integer <int32>

When there are values for both start and end, duration is ignored. The stop parameter can be used instead of the duration parameter.

assignee
integer <int32>

Workspace owners and admins can include any user id. Workspace members can only include their own user id.

tid
string
Responses
200
post/team/{team_Id}/time_entries
Request samples
application/json
{
  • "description": "from api",
  • "tags": [
    ],
  • "start": 1595282645000,
  • "billable": true,
  • "duration": 50000,
  • "assignee": 1,
  • "tid": "task_id"
}
Response samples
application/json
{
  • "description": "from api",
  • "tags": [
    ],
  • "start": 1595282645000,
  • "billable": true,
  • "duration": 50000,
  • "assignee": 1,
  • "tid": "task_id"
}
ClickUp Logo