---
title: "Create a new time entry"
method: POST
path: "/timeEntries"
tags: ["Time Entries"]
---

# Create a new time entry

`POST /timeEntries`

Create a new time entry

## Request body

- CreateTimeEntry
  - `user_id` string, required
  - `client_id` string, nullable
  - `project_id` string, nullable
  - `service_id` string, nullable
  - `description` string, nullable
  - `started_at` string, date-time, required
  - `ended_at` string, date-time, nullable
  - `ext_tool_id` string, nullable
  - `temp_id` string, nullable
  - `billed_at` string, date-time, nullable
  - `is_interrupt` boolean, nullable
  - `billable` boolean, nullable
  - `temp_id_should_be_unique` boolean, nullable

## Response `201`

Time Entry created

- object
  - `data` TimeEntry
    - `id` string, ulid
    - `user_id` string, ulid
    - `client_id` string, ulid
    - `project_id` string, ulid
    - `service_id` string, ulid
    - `description` string
    - `billable` boolean
    - `billed` boolean
    - `billed_at` string, date-time
    - `is_interrupt` boolean
    - `started_at` string, date-time
    - `ended_at` string, date-time
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `deleted_at` string, date-time
    - `ext_tool_id` string, ulid
    - `temp_id` string
    - `push_state` integer
    - `push_errors` string[]
  - `success` boolean

## Other responses

- `401` — Error: Unauthorized
- `403` — Forbidden access or subscription and trial phase ended.
- `422` — Validation failed

---

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