CLclickup
Time Tracking

Create a time entry

Changed on

Create a time entry.

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

post/v2/team/{team_Id}/time_entries

Request

  • Base URL
    https://api.clickup.com/api
  • URL
    https://api.clickup.com/api/v2/team/{team_Id}/time_entries
  • Auth
    API key in header Authorization

Path parameters

team_Idnumber required
Example:123

Workspace ID

Query parameters

custom_task_idsboolean
Example:true

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

team_idnumber
Example:123

When the custom_task_ids parameter is set to true, the Workspace ID must be provided using the team_id parameter.
For example: custom_task_ids=true&team_id=123.

Request body

descriptionstring
startinteger required
stopinteger

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

endinteger
billableboolean
durationinteger required

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

assigneeinteger

Workspace owners and admins can include any user id. Workspace members can only include their own user id. Unlimited uses of creating time entries for other people is available on the Business Plus and Enterprise Plan.

tidstring

You can provide a task ID to associate the time entry with a task. Unlimited uses of time entries that are not associated with tasks are available on the Business Plus and Enterprise Plan.

Example request

{
  "description": "from api",
  "tags": [
    {
      "name": "name of tag",
      "tag_bg": "#BF55EC",
      "tag_fg": "#FFFFFF"
    }
  ],
  "start": 1595282645000,
  "end": 1595282660000,
  "billable": true,
  "duration": 50000,
  "assignee": 1,
  "tid": "task_id"
}

Response

descriptionstring required
tagsItems[] required(unresolved $ref)
startinteger required
billableboolean required
durationinteger required
assigneeinteger required
tidstring required

Example response

{
  "description": "from api",
  "tags": [
    {
      "name": "name of tag",
      "tag_bg": "#BF55EC",
      "tag_fg": "#BF55EC"
    }
  ],
  "start": 1595282645000,
  "billable": true,
  "duration": 50000,
  "assignee": 1,
  "tid": "task_id"
}

Changes

  • a0a72ec97ddbRevision changes
    • breaking

      the / response's property type changed from no type to object for status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status