Nothing Found

Start a time Entry

Start a timer for the authenticated 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
required

For Workspaces on the Free Forever or Unlimited Plan, either the timer_id parameter or the "tid" field in the body of the request are required fields.

description
string
Array of objects (Tags10)

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

tid
string
billable
boolean
Responses
200
post/v2/team/{team_Id}/time_entries/start
Request samples
application/json
{
  • "description": "from api",
  • "tags": [
    ],
  • "tid": "task_id",
  • "billable": false
}
Response samples
application/json
{
  • "data": {
    }
}
ClickUp Logo
Login