v1

latestOpenAPI 3.0.02026-08-061478520.6 KB
[v3] Time Entry

Create time entry

Create a time entry.

post/v3/time-entries/create

Headers

Acceptstring
Example:application/json
Tc-servicestring
Example:tc_web

Optional service name used for activity and analytics context.

Request body

datestring date required
startTimestring
endTimestring
durationinteger

Duration in seconds. If omitted, duration is calculated from start and end.

taskIdinteger
externalTaskIdstring
assignedUserIdinteger
userEmailstring email
taskNameSearchstring
notestring
descriptionstring
customIdstring
billableboolean
baseEntryIdinteger
placestring

Example request

{
  "date": "2026-06-18",
  "startTime": "09:00:00",
  "endTime": "10:00:00",
  "duration": 3600,
  "taskId": 123,
  "externalTaskId": "card_123",
  "assignedUserId": 456,
  "userEmail": "user@example.com",
  "taskNameSearch": "Project task",
  "note": "Work note",
  "description": "Work note",
  "customId": "EXT-123",
  "billable": true,
  "baseEntryId": 100,
  "place": "timesheet"
}

Response

Time entry created.

Example response

{
  "data": {
    "id": 123,
    "duration": 3600,
    "userId": 456,
    "taskId": 123,
    "date": "2026-06-18",
    "startTime": "09:00:00",
    "endTime": "10:00:00",
    "description": "Work note",
    "billable": true,
    "tags": [
      7
    ]
  },
  "meta": {
    "tags": [
      {
        "id": 7,
        "name": "My tag"
      }
    ]
  }
}