Sign in
[v3] Timer

Start timer

Start a timer for the authenticated user.

post/v3/timer/start

Headers

Acceptstring
Example:application/json
Content-Typestring
Example:application/json

Request body

taskIdinteger nullable

Local task id. When provided without externalTaskId, the response contains the local task name.

externalTaskIdstring nullable

External task id from the requesting integration.

externalTaskNamestring nullable

External task name used as the entry note when the external task is not synchronized locally.

sourceEntryIdinteger nullable

Previous entry id used to preserve pending timer synchronization for external tasks.

startedAtstring nullable

Local timer start time.

placestring nullable

Optional analytics source.

notestring nullable

Timer note saved on a created entry.

browserPluginButtonHashstring nullable

Browser plugin button hash assigned to the timer.

tagsobject[]

Tags assigned to the created entry when the tags module is enabled.

Example request

{
  "taskId": 123,
  "externalTaskId": "TASK-1",
  "externalTaskName": "External task",
  "sourceEntryId": 101,
  "startedAt": "2026-07-01 10:00:00",
  "place": "timesheet",
  "note": "Timer note",
  "browserPluginButtonHash": "button-hash"
}

Response

OK

Changes