GitScrum / Docs

Timer Started

Webhook payload reference for the time-tracking.issues.start event, triggered when a timer starts on a task.

Triggered when a team member starts the time tracker on a task.

  • Event: time-tracking.issues.start
  • Category: Tasks
  • Triggers: Clicking the start timer button on a task

Payload

{
  "uuid": 123,
  "task": {
    "uuid": "abc123-def456-ghi789"
  },
  "user": {
    "id": 1,
    "uuid": "user-uuid-123",
    "name": "Jane Smith",
    "username": "janesmith",
    "avatar": "https://avatar.url/jane.jpg",
    "headline": "Lead Developer",
    "location": "Porto, Portugal",
    "timezone_name": "Europe/Lisbon",
    "language": "en",
    "created_at": {
      "date_for_humans": "1 year ago",
      "iso8601": "2025-01-15T10:00:00+00:00",
      "timestamp": 1736935200
    }
  },
  "comment": null,
  "status": "start",
  "time": "2026-02-06 14:30:00",
  "auto_assigned": false
}

Field Reference

FieldTypeDescription
uuidintegerTime tracking record ID
task.uuidstringUUID of the task
userobjectUser who started the timer
commentstring or nullAlways null on start
statusstringAlways "start" for this event
timestringStart datetime (Y-m-d H:i:s)
auto_assignedbooleantrue if the user was auto-assigned to the task

Notes

  • The auto_assigned field is true when starting a timer automatically assigns the user to the task (if they weren't already assigned).
  • Only one active timer per user per task is allowed.

Related