clickup-time-tracking

ClickUp Time Tracking - Time entries, timers, tags, and webhooks

Server path: /clickup-time-tracking | Type: Application | PCID required: Yes

Tools

Tool	Description
clickup_time_tracking_addtagsfromtimeentries	Add tags from time entries
clickup_time_tracking_changetagnamesfromtimeentries	Change tag names from time entries
clickup_time_tracking_create_webhook	Create Webhook
clickup_time_tracking_createatimeentry	Create a time entry
clickup_time_tracking_delete_webhook	Delete Webhook
clickup_time_tracking_deleteatime_entry	Delete a time Entry
clickup_time_tracking_get_webhooks	Get Webhooks
clickup_time_tracking_getalltagsfromtimeentries	Get all tags from time entries
clickup_time_tracking_getrunningtimeentry	Get running time entry
clickup_time_tracking_getsingulartimeentry	Get singular time entry
clickup_time_tracking_gettimeentrieswithinadaterange	Get time entries within a date range
clickup_time_tracking_gettimeentryhistory	Get time entry history
clickup_time_tracking_removetagsfromtimeentries	Remove tags from time entries
clickup_time_tracking_startatime_entry	Start a time Entry
clickup_time_tracking_stopatime_entry	Stop a time Entry
clickup_time_tracking_update_webhook	Update Webhook
clickup_time_tracking_updateatime_entry	Update a time Entry

---

clickup_time_tracking_addtagsfromtimeentries

Add tags from time entries

Parameters:

Parameter	Type	Required	Default	Description
team_id	number	Yes	—	Workspace ID
tags	object[]	Yes	—	The tags value
time_entry_ids	string[]	Yes	—	Time Entry Ids

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "team_id": {
      "type": "number",
      "description": "Workspace ID"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "The tags value"
    },
    "time_entry_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Time Entry Ids"
    }
  },
  "required": [
    "PCID",
    "team_id",
    "tags",
    "time_entry_ids"
  ]
}

---

clickup_time_tracking_changetagnamesfromtimeentries

Change tag names from time entries

Parameters:

Parameter	Type	Required	Default	Description
team_id	number	Yes	—	Workspace ID
name	string	Yes	—	The name value
new_name	string	Yes	—	New Name
tag_bg	string	Yes	—	Tag Bg
tag_fg	string	Yes	—	Tag Fg

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "team_id": {
      "type": "number",
      "description": "Workspace ID"
    },
    "name": {
      "type": "string",
      "description": "The name value"
    },
    "new_name": {
      "type": "string",
      "description": "New Name"
    },
    "tag_bg": {
      "type": "string",
      "description": "Tag Bg"
    },
    "tag_fg": {
      "type": "string",
      "description": "Tag Fg"
    }
  },
  "required": [
    "PCID",
    "team_id",
    "name",
    "new_name",
    "tag_bg",
    "tag_fg"
  ]
}

---

clickup_time_tracking_create_webhook

Create Webhook

Parameters:

Parameter	Type	Required	Default	Description
team_id	number	Yes	—	Workspace ID
endpoint	string	Yes	—	The endpoint value
events	string[]	Yes	—	See documentation for available event options. Use * to subscribe to all events.
folder_id	integer	No	—	Folder Id
list_id	integer	No	—	List Id
space_id	integer	No	—	Space Id
task_id	string	No	—	Task Id

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "team_id": {
      "type": "number",
      "description": "Workspace ID"
    },
    "endpoint": {
      "type": "string",
      "description": "The endpoint value"
    },
    "events": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "See [documentation](doc:webhooks#task-webhooks) for available event options. Use `*` to subscribe to all events."
    },
    "folder_id": {
      "type": "integer",
      "description": "Folder Id"
    },
    "list_id": {
      "type": "integer",
      "description": "List Id"
    },
    "space_id": {
      "type": "integer",
      "description": "Space Id"
    },
    "task_id": {
      "type": "string",
      "description": "Task Id"
    }
  },
  "required": [
    "PCID",
    "team_id",
    "endpoint",
    "events"
  ]
}

---

clickup_time_tracking_createatimeentry

Create a time entry

Parameters:

Parameter	Type	Required	Default	Description
team_Id	number	Yes	—	Workspace ID
custom_task_ids	boolean	No	—	If you want to reference a task by it’s custom task id, this value must be true.
assignee	integer	No	—	Workspace owners and admins can include any user id. Workspace members can only include their own user id.
billable	boolean	No	—	The billable value
description	string	No	—	The description value
duration	integer	Yes	—	When there are values for both start and end, duration is ignored. The stop parameter can be used instead of the duration parameter.
end	integer	No	—	The end value
start	integer	Yes	—	The start value
stop	integer	No	—	The duration parameter can be used instead of the stop parameter.
tags	object[]	No	—	Users on the Business Plan and above can include a time tracking label.
tid	string	No	—	The tid value

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "team_Id": {
      "type": "number",
      "description": "Workspace ID"
    },
    "custom_task_ids": {
      "type": "boolean",
      "description": "If you want to reference a task by it's custom task id, this value must be `true`."
    },
    "assignee": {
      "type": "integer",
      "description": "Workspace owners and admins can include any user id. Workspace members can only include their own user id."
    },
    "billable": {
      "type": "boolean",
      "description": "The billable value"
    },
    "description": {
      "type": "string",
      "description": "The description value"
    },
    "duration": {
      "type": "integer",
      "description": "When there are values for both `start` and `end`, `duration` is ignored. The `stop` parameter can be used instead of the `duration` parameter."
    },
    "end": {
      "type": "integer",
      "description": "The end value"
    },
    "start": {
      "type": "integer",
      "description": "The start value"
    },
    "stop": {
      "type": "integer",
      "description": "The `duration` parameter can be used instead of the `stop` parameter."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Users on the Business Plan and above can include a time tracking label."
    },
    "tid": {
      "type": "string",
      "description": "The tid value"
    }
  },
  "required": [
    "PCID",
    "team_Id",
    "duration",
    "start"
  ]
}

---

clickup_time_tracking_delete_webhook

Delete Webhook

Parameters:

Parameter	Type	Required	Default	Description
webhook_id	string	Yes	—	e506-4a29-9d42-26e504e3435e (uuid)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "webhook_id": {
      "type": "string",
      "description": "e506-4a29-9d42-26e504e3435e (uuid)"
    }
  },
  "required": [
    "PCID",
    "webhook_id"
  ]
}

---

clickup_time_tracking_deleteatime_entry

Delete a time Entry

Parameters:

Parameter	Type	Required	Default	Description
team_id	number	Yes	—	Workspace ID
timer_id	string	Yes	—	Array of timer ids to delete separated by commas

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "team_id": {
      "type": "number",
      "description": "Workspace ID"
    },
    "timer_id": {
      "type": "string",
      "description": "Array of timer ids to delete separated by commas"
    }
  },
  "required": [
    "PCID",
    "team_id",
    "timer_id"
  ]
}

---

clickup_time_tracking_get_webhooks

Get Webhooks

Parameters:

Parameter	Type	Required	Default	Description
team_id	number	Yes	—	Workspace ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "team_id": {
      "type": "number",
      "description": "Workspace ID"
    }
  },
  "required": [
    "PCID",
    "team_id"
  ]
}

---

clickup_time_tracking_getalltagsfromtimeentries

Get all tags from time entries

Parameters:

Parameter	Type	Required	Default	Description
team_id	number	Yes	—	Workspace ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "team_id": {
      "type": "number",
      "description": "Workspace ID"
    }
  },
  "required": [
    "PCID",
    "team_id"
  ]
}

---

clickup_time_tracking_getrunningtimeentry

Get running time entry

Parameters:

Parameter	Type	Required	Default	Description
team_id	number	Yes	—	Workspace ID
assignee	number	No	—	user id

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "team_id": {
      "type": "number",
      "description": "Workspace ID"
    },
    "assignee": {
      "type": "number",
      "description": "user id"
    }
  },
  "required": [
    "PCID",
    "team_id"
  ]
}

---

clickup_time_tracking_getsingulartimeentry

Get singular time entry

Parameters:

Parameter	Type	Required	Default	Description
team_id	number	Yes	—	Workspace ID
timer_id	string	Yes	—	The ID of a time entry. \ \ This can be found using the Get Time Entries Within a Date Range endpoint.
include_task_tags	boolean	No	—	Include task tags in the response for time entries associated with tasks.
include_location_names	boolean	No	—	Include the names of the List, Folder, and Space along with list_id,folder_id, and space_id.
include_approval_history	boolean	No	—	Include the history of the approval for the time entry.
include_approval_details	boolean	No	—	Include the details of the approval for the time entry.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "team_id": {
      "type": "number",
      "description": "Workspace ID"
    },
    "timer_id": {
      "type": "string",
      "description": "The ID of a time entry. \\  \\ This can be found using the [Get Time Entries Within a Date Range](ref:gettimeentrieswithinadaterange) endpoint."
    },
    "include_task_tags": {
      "type": "boolean",
      "description": "Include task tags in the response for time entries associated with tasks."
    },
    "include_location_names": {
      "type": "boolean",
      "description": "Include the names of the List, Folder, and Space along with `list_id`,`folder_id`, and `space_id`."
    },
    "include_approval_history": {
      "type": "boolean",
      "description": "Include the history of the approval for the time entry."
    },
    "include_approval_details": {
      "type": "boolean",
      "description": "Include the details of the approval for the time entry."
    }
  },
  "required": [
    "PCID",
    "team_id",
    "timer_id"
  ]
}

---

clickup_time_tracking_gettimeentrieswithinadaterange

Get time entries within a date range

Parameters:

Parameter	Type	Required	Default	Description
team_Id	number	Yes	—	Workspace ID
start_date	number	No	—	Unix time in milliseconds
end_date	number	No	—	Unix time in milliseconds
assignee	number	No	—	Filter by user_id. For multiple assignees, separate user_id using commas.\ \ Example: assignee=1234,9876\ \ Note: Only Workspace Owners/Admins have access to do this.
include_task_tags	boolean	No	—	Include task tags in the response for time entries associated with tasks.
include_location_names	boolean	No	—	Include the names of the List, Folder, and Space along with the list_id,folder_id, and space_id.
include_approval_history	boolean	No	—	Include the history of the approval for each time entry. Adds status changes, notes, and approvers.
include_approval_details	boolean	No	—	Include the details of the approval for each time entry. Adds Approver ID, Approved Time, List of Approvers, and Approval Status.
space_id	number	No	—	Only include time entries associated with tasks in a specific Space.
folder_id	number	No	—	Only include time entries associated with tasks in a specific Folder.
list_id	number	No	—	Only include time entries associated with tasks in a specific List.
task_id	string	No	—	Only include time entries associated with a specific task.
custom_task_ids	boolean	No	—	If you want to reference a task by it’s custom task id, this value must be true.
is_billable	boolean	No	—	Include only billable time entries by using a value of true or only non-billable time entries by using a value of false.\ \ For example: ?is_billable=true.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "team_Id": {
      "type": "number",
      "description": "Workspace ID"
    },
    "start_date": {
      "type": "number",
      "description": "Unix time in milliseconds"
    },
    "end_date": {
      "type": "number",
      "description": "Unix time in milliseconds"
    },
    "assignee": {
      "type": "number",
      "description": "Filter by `user_id`. For multiple assignees, separate `user_id` using commas.\\  \\  **Example:** `assignee=1234,9876`\\  \\ ***Note:** Only Workspace Owners/Admins have access to do this.*"
    },
    "include_task_tags": {
      "type": "boolean",
      "description": "Include task tags in the response for time entries associated with tasks."
    },
    "include_location_names": {
      "type": "boolean",
      "description": "Include the names of the List, Folder, and Space along with the `list_id`,`folder_id`, and `space_id`."
    },
    "include_approval_history": {
      "type": "boolean",
      "description": "Include the history of the approval for each time entry. Adds status changes, notes, and approvers."
    },
    "include_approval_details": {
      "type": "boolean",
      "description": "Include the details of the approval for each time entry. Adds Approver ID, Approved Time, List of Approvers, and Approval Status."
    },
    "space_id": {
      "type": "number",
      "description": "Only include time entries associated with tasks in a specific Space."
    },
    "folder_id": {
      "type": "number",
      "description": "Only include time entries associated with tasks in a specific Folder."
    },
    "list_id": {
      "type": "number",
      "description": "Only include time entries associated with tasks in a specific List."
    },
    "task_id": {
      "type": "string",
      "description": "Only include time entries associated with a specific task."
    },
    "custom_task_ids": {
      "type": "boolean",
      "description": "If you want to reference a task by it's custom task id, this value must be `true`."
    },
    "is_billable": {
      "type": "boolean",
      "description": "Include only billable time entries by using a value of `true` or only non-billable time entries by using a value of `false`.\\  \\ For example: `?is_billable=true`."
    }
  },
  "required": [
    "PCID",
    "team_Id"
  ]
}

---

clickup_time_tracking_gettimeentryhistory

Get time entry history

Parameters:

Parameter	Type	Required	Default	Description
team_id	number	Yes	—	Workspace ID
timer_id	string	Yes	—	The ID of a time entry. \ \ This can be found using the Get Time Entries Within a Date Range endpoint.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "team_id": {
      "type": "number",
      "description": "Workspace ID"
    },
    "timer_id": {
      "type": "string",
      "description": "The ID of a time entry. \\  \\ This can be found using the [Get Time Entries Within a Date Range](ref:gettimeentrieswithinadaterange) endpoint."
    }
  },
  "required": [
    "PCID",
    "team_id",
    "timer_id"
  ]
}

---

clickup_time_tracking_removetagsfromtimeentries

Remove tags from time entries

Parameters:

Parameter	Type	Required	Default	Description
team_id	number	Yes	—	Workspace ID
tags	object[]	Yes	—	The tags value
time_entry_ids	string[]	Yes	—	Time Entry Ids

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "team_id": {
      "type": "number",
      "description": "Workspace ID"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "The tags value"
    },
    "time_entry_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Time Entry Ids"
    }
  },
  "required": [
    "PCID",
    "team_id",
    "tags",
    "time_entry_ids"
  ]
}

---

clickup_time_tracking_startatime_entry

Start a time Entry

Parameters:

Parameter	Type	Required	Default	Description
team_Id	number	Yes	—	Workspace ID
custom_task_ids	boolean	No	—	If you want to reference a task by it’s custom task id, this value must be true.
billable	boolean	No	—	The billable value
description	string	No	—	The description value
tags	object[]	No	—	Users on the Business Plan and above can include a time tracking label.
tid	string	No	—	The tid value

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "team_Id": {
      "type": "number",
      "description": "Workspace ID"
    },
    "custom_task_ids": {
      "type": "boolean",
      "description": "If you want to reference a task by it's custom task id, this value must be `true`."
    },
    "billable": {
      "type": "boolean",
      "description": "The billable value"
    },
    "description": {
      "type": "string",
      "description": "The description value"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Users on the Business Plan and above can include a time tracking label."
    },
    "tid": {
      "type": "string",
      "description": "The tid value"
    }
  },
  "required": [
    "PCID",
    "team_Id"
  ]
}

---

clickup_time_tracking_stopatime_entry

Stop a time Entry

Parameters:

Parameter	Type	Required	Default	Description
team_id	number	Yes	—	Workspace ID

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "team_id": {
      "type": "number",
      "description": "Workspace ID"
    }
  },
  "required": [
    "PCID",
    "team_id"
  ]
}

---

clickup_time_tracking_update_webhook

Update Webhook

Parameters:

Parameter	Type	Required	Default	Description
webhook_id	string	Yes	—	e506-4a29-9d42-26e504e3435e (uuid)
endpoint	string	Yes	—	The endpoint value
events	string[]	Yes	—	Array of webhook event names
status	string	Yes	—	The status value

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "webhook_id": {
      "type": "string",
      "description": "e506-4a29-9d42-26e504e3435e (uuid)"
    },
    "endpoint": {
      "type": "string",
      "description": "The endpoint value"
    },
    "events": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of webhook event names"
    },
    "status": {
      "type": "string",
      "description": "The status value"
    }
  },
  "required": [
    "PCID",
    "webhook_id",
    "endpoint",
    "events",
    "status"
  ]
}

---

clickup_time_tracking_updateatime_entry

Update a time Entry

Parameters:

Parameter	Type	Required	Default	Description
team_id	number	Yes	—	Workspace ID
timer_id	string	Yes	—	Timer Id
custom_task_ids	boolean	No	—	If you want to reference a task by it’s custom task id, this value must be true.
billable	boolean	No	—	The billable value
description	string	No	—	The description value
duration	integer	No	—	The duration value
end	integer	No	—	When providing end, you must also provide start.
start	integer	No	—	When providing start, you must also provide end.
tag_action	string	No	—	Tag Action
tags	object[]	No	—	Users on the Business Plan and above can include a time tracking label.
tid	string	No	—	The tid value

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "team_id": {
      "type": "number",
      "description": "Workspace ID"
    },
    "timer_id": {
      "type": "string",
      "description": "Timer Id"
    },
    "custom_task_ids": {
      "type": "boolean",
      "description": "If you want to reference a task by it's custom task id, this value must be `true`."
    },
    "billable": {
      "type": "boolean",
      "description": "The billable value"
    },
    "description": {
      "type": "string",
      "description": "The description value"
    },
    "duration": {
      "type": "integer",
      "description": "The duration value"
    },
    "end": {
      "type": "integer",
      "description": "When providing `end`, you must also provide `start`."
    },
    "start": {
      "type": "integer",
      "description": "When providing `start`, you must also provide `end`."
    },
    "tag_action": {
      "type": "string",
      "description": "Tag Action"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "Users on the Business Plan and above can include a time tracking label."
    },
    "tid": {
      "type": "string",
      "description": "The tid value"
    }
  },
  "required": [
    "PCID",
    "team_id",
    "timer_id"
  ]
}