Sign in

v1

latestOpenAPI 3.1.02026-07-242735131.1 MB
Timesheets

Create a contractor timesheet

Creates a timesheet on behalf of a contractor employment.

The submitted hours are immediately available to the contractor in the Remote UI for self-serve invoice creation (Invoices → Create invoice → "Use Time Tracking").

This endpoint is restricted to contractor employments. Calls against EOR or Global Payroll employments are rejected with 422.

Scopes

CategoryRead only ScopeWrite only Scope (read access implicit)
Manage timeoffs (time_and_attendance)-Manage timesheets (timesheet:write)
post/v1/contractors/employments/{employment_id}/timesheets

Path parameters

employment_idstring required

Contractor employment ID

Request body

end_datestring date required

UTC date in ISO 8601 format

start_datestring date required

UTC date in ISO 8601 format

Example request

{
  "end_date": "2021-07-01",
  "start_date": "2021-07-01",
  "time_trackings": [
    {
      "clock_in": "2021-07-15T18:18:17Z",
      "clock_out": "2021-07-15T18:18:17Z",
      "notes": "Project Alpha",
      "timezone": "Etc/UTC",
      "type": "regular_hours"
    }
  ]
}

Response

Success

Example response

{
  "data": {
    "timesheet": {
      "break_hours": {
        "hours": 35,
        "minutes": 13
      },
      "country_code": "PRT",
      "employment_id": "663e0b79-c893-45ff-a1b2-f6dcabc098b5",
      "end_date": "2021-07-01",
      "id": "663e0b79-c893-45ff-a1b2-f6dcabc098b5",
      "notes": null,
      "on_call_hours": {
        "hours": 35,
        "minutes": 13
      },
      "regular_hours": {
        "hours": 35,
        "minutes": 13
      },
      "start_date": "2021-07-01",
      "submitted_at": "2021-07-15T18:18:17Z",
      "time_trackings": [
        {
          "clock_in": "2021-07-15T18:18:17Z",
          "clock_out": "2021-07-15T18:18:17Z",
          "notes": "Project Alpha",
          "timezone": "Etc/UTC",
          "total_hours": {
            "hours": 35,
            "minutes": 13
          },
          "type": "regular_hours"
        }
      ],
      "total_hours": {
        "hours": 35,
        "minutes": 13
      }
    }
  }
}