Create a contractor timesheet

Creates a timesheet on behalf of a contractor employment.

The timesheet is created as an open draft, matching a timesheet the contractor creates
themselves: the contractor can still edit the hours, and the customer approves them through the
contractor's invoice rather than the timesheet. Contractor timesheets can't be submitted or
approved through the API.

The 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.

Authentication

This endpoint accepts any one of the following token types:

  • Company-scoped access token (OAuth2AuthorizationCode) — obtained by a company manager through the Authorization Code flow or the Refresh Token flow. See Authentication for partners.
  • Company-scoped access token (assertion) (OAuth2CompanyManagerAssertion) — obtained through the urn:ietf:params:oauth:grant-type:jwt-bearer grant for a company manager. See OAuth Assertion.
  • Customer API token (CustomerAPIToken) — generated by the customer on their Integration Settings page, with the scopes they choose there. See Authorization for customers.

Scopes

Any one of the scopes in a token type's row is enough. all:write works too.

Token typeCategoryRead only ScopeWrite only Scope (read access implicit)
Company-scoped access tokenManage timeoffs (time_and_attendance)-Manage timesheets (timesheet:write)
Company-scoped access token (assertion)Manage timeoffs (time_and_attendance)-Manage timesheets (timesheet:write)
Customer API tokenManage timeoffs (time_and_attendance)-Manage timesheets (timesheet:write)
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Contractor employment ID

Body Params

ContractorCreateTimesheetParams

Parameters for creating a timesheet on behalf of a contractor employment. The target employment is taken from the URL path, not the request body. Allowed time_trackings.type values are restricted to the contractor subset: regular_hours, on_call, break.

date
required

UTC date in ISO 8601 format

date
required

UTC date in ISO 8601 format

time_trackings
array of objects
required
length ≥ 1

One or more time tracking entries to include in the timesheet.

time_trackings*
Responses

Callback
Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json