timesheets

Create Timesheet

Create a new timesheet (time entry) for a worker on a project, account, or opportunity (and optionally a work order).

post/timesheets

Request

  • Base URL: https://api.coperniq.io/v1
  • URL: https://api.coperniq.io/v1/timesheets
  • Auth: API key in header x-api-key

Request body

projectIdinteger

Project this time entry belongs to. Exactly one of projectId, accountId, or opportunityId is required.

accountIdinteger

Account this time entry belongs to. Exactly one of projectId, accountId, or opportunityId is required.

opportunityIdinteger

Opportunity this time entry belongs to. Exactly one of projectId, accountId, or opportunityId is required.

workOrderIdinteger nullable

Work order this time entry is logged against, if any.

targetUserIdinteger required

Worker the time entry is logged for.

type'WORKING' | 'TRAVEL' required
startDatestring date-time required
endDatestring date-time required

Must be after startDate.

distancenumber double nullable
laborHourlyRatenumber double nullable
notestring nullable

Response

Timesheet created successfully

idinteger

Unique identifier.

type'WORKING' | 'TRAVEL'

Time entry type.

status'PROCESSING' | 'PROCESSED' | 'FAILED'

Processing status of the time entry.

startDatestring date-time nullable
endDatestring date-time nullable
distancenumber double nullable

Distance traveled, for TRAVEL entries.

notestring nullable
isArchivedboolean nullable
createdAtstring date-time
updatedAtstring date-time
projectIdinteger nullable

Set when the linked record is a Project. Null when it is an Account (see accountId) or Opportunity (see opportunityId).

accountIdinteger nullable

Set when the linked record is an Account. Null otherwise.

opportunityIdinteger nullable

Set when the linked record is an Opportunity. Null otherwise.

workOrderIdinteger nullable
targetUserIdinteger nullable

The worker the time entry is logged for.

createdByinteger nullable
updatedByinteger nullable
laborHourlyRatenumber double nullable

Labor cost ($/hr). Only visible with the appropriate financial privilege.

laborTotalCostnumber double nullable

Only visible with the appropriate financial privilege.

Changes

No recorded changes to this operation across all 1 revision of this API.