Create a time sheet

post

https://api.gusto-demo.com/v1/companies/{company_uuid}/time_tracking/time_sheets

Create a time sheet for a company.

Time sheets represent the time worked by an employee or contractor for a given time range. Hours are classified by pay classification, and can be regular, overtime, or double overtime.

scope: time_sheet:write

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

company_uuid

string

required

The UUID of the company

Body Params

entity_uuid

string

required

Unique identifier of the entity associated with the time sheet.

entity_type

string

required

Type of entity associated with the time sheet.

job_uuid

string

Unique identifier of the job for which time is tracked.

time_zone

string

required

Time zone of where the time is tracked.

shift_started_at

date-time

required

ISO 8601 timestamp of when the shift was started.

shift_ended_at

date-time

ISO 8601 timestamp of when the shift was ended. If the shift is still ongoing you can omit this field.

metadata

object

Metadata associated with the time sheet. Key-value pairs of arbitrary data. Both keys and values must be strings.

entries

array of objects

Entries associated with the time sheet.

entries

Headers

X-Gusto-API-Version

string

enum

Defaults to 2026-02-01

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Allowed:

Responses

404

Not Found

The requested resource does not exist. Make sure the provided UUID is valid.

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Example response

422Unprocessable Entity This may happen when the body of your request contains errors such as invalid_attribute_value, or the request fails due to an invalid_operation. See the Errors Categories guide for more details.