Sign in
latestOpenAPI 3.0.02026-08-1284111344.5 KB

14666f4db0f8

TimeSheets

Create a new Time Sheet

Creates a new Time Sheet and returns the created Time Sheet object.

post/v2/timeSheet

Headers

Authorizationstring required
Example:Bearer <token>

Bearer Token

Request body

techIdstring required

The ID of the user to clock into this shift (prefix USR-).

jobIdstring

The ID of the job associated with this shift (prefix JOB-).

laborCostnumber

The labor cost per hour of this shift.

startDatestring required

The start date and time of the shift.

endDatestring required

The end date and time of the shift.

notesstring

The notes of the shift.

Example request

{
  "techId": "USR-81ce48127c24fd23",
  "jobId": "JOB-BA5r7o4bqzR9MONa",
  "laborCost": 25,
  "startDate": "2024-07-25 09:00:00",
  "endDate": "2024-07-25 09:00:00",
  "notes": "This is a note"
}

Response

The created Time Sheet.

idstring

The ID of the time sheet (prefix TS-).

techIdstring

The ID of the user logged to this shift (prefix USR-).

techNamestring

The name of the user logged to this shift.

startDatestring

The start date and time of the shift.

endDatestring

The end date and time of the shift.

notesstring

The notes of the shift.

jobIdstring

The ID of the job associated with this shift (prefix JOB-).

laborCostnumber

The labor cost per hour of this shift.

shiftLengthstring

The length of the shift in hours.

Example response

{
  "id": "TS-de9750285414508f",
  "techId": "USR-81ce48127c24fd23",
  "techName": "John Doe",
  "startDate": "2024-01-24 08:00:00",
  "endDate": "2024-01-24 16:00:00",
  "notes": "This is a note",
  "jobId": "JOB-BA5r7o4bqzR9MONa",
  "laborCost": 34.75,
  "shiftLength": "08:00"
}