---
title: "Create time entry"
method: POST
path: "/v3/time-entries/create"
tags: ["[v3] Time Entry"]
---

# Create time entry

`POST /v3/time-entries/create`

Create a time entry.

## Headers

- `Accept` string
- `Tc-service` string

## Request body

- object
  - `date` string, date, required
  - `startTime` string
  - `endTime` string
  - `duration` integer — Duration in seconds. If omitted, duration is calculated from start and end.
  - `taskId` integer
  - `externalTaskId` string
  - `assignedUserId` integer
  - `userEmail` string, email
  - `taskNameSearch` string
  - `note` string
  - `description` string
  - `customId` string
  - `billable` boolean
  - `tags` union[]
    - union
      - integer
      - object
        - `tagId` integer
  - `baseEntryId` integer
  - `place` string

## Response `201`

Time entry created.

- object
  - `data` object
    - `id` integer
    - `duration` integer
    - `userId` integer
    - `taskId` integer
    - `date` string, date
    - `startTime` string
    - `endTime` string
    - `description` string, nullable
    - `billable` boolean
    - `tags` integer[], nullable
  - `meta` object
    - `tags` object[] — Tag metadata for tags assigned to the created time entry.
      - `id` integer, required
      - `name` string, required

## Other responses

- `400` — Invalid request payload.
- `401` — Unauthorized.
- `403` — Forbidden.

---

[API](https://skmtc.net/timecamp/apis/timecamp-api.md) · [All operations](https://skmtc.net/timecamp/apis/timecamp-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/timecamp/timecamp-api/revisions/c7e9d1f9cf61/schema)
