---
title: "Create a time entry"
method: POST
path: "/v2/team/{team_Id}/time_entries"
tags: ["Time Tracking"]
---

# Create a time entry

`POST /v2/team/{team_Id}/time_entries`

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

## Path parameters

- `team_Id` number, required

## Query parameters

- `custom_task_ids` boolean
- `team_id` number

## Request body

- object
  - `description` string
  - `tags` object[] — Unlimited uses of time entry tags are available on the Business Plus and Enterprise Plan.
    - `name` string, required
    - `tag_fg` string, required
    - `tag_bg` string, required
  - `start` integer, required
  - `stop` integer — The `duration` parameter can be used instead of the `stop` parameter.
  - `end` integer
  - `billable` boolean
  - `duration` integer, required — 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 — 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.
  - `tid` string — 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.

## Response `200`

- object
  - `description` string, required
  - `tags` Items[], required — unresolved $ref
  - `start` integer, required
  - `billable` boolean, required
  - `duration` integer, required
  - `assignee` integer, required
  - `tid` string, required

---

[API](https://skmtc.dev/clickup/apis/clickup-api-v2-reference.md) · [All operations](https://skmtc.dev/clickup/apis/clickup-api-v2-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clickup/clickup-api-v2-reference/revisions/72216f55b952/schema)