---
title: "Create TimeSheet"
method: POST
path: "/v1/timesheets"
tags: ["Timesheets"]
---

# Create TimeSheet

`POST /v1/timesheets`

Creates a new TimeSheet.

## Headers

- `RequestId` string, uuid — The unique request identifier used to correlate request data with log entries and events, formatted as a UUID.
- `FrontOfficeTenantId` integer
- `Tenant` string

## Request body

- TimeSheetDto
  - `id` integer — The identifier for the timesheet.
  - `placementId` integer, required — The identifier for the placement. It allows the timesheet to be correlated with the talent to whom the time belongs.
  - `weekWorked` string, date-time, required — The week ending date. This is just a date stamp, no time should be included.
  - `dailyTime` TimeEntryDto[], required — A list of time entries and their details.
    - `dayWorked` string, date-time, required — The date for the time entry. This should be just a date stamp. No time should be included.
    - `timeIn` string — The start time of the day.
    - `timeOut` string — The end time of the day.
    - `breakOut` string — The break start time.
    - `breakIn` string — The break end time.
    - `breakUnit` number — The break unit.
    - `additionalTimeEntry` AdditionalTimeEntryDto[] — List of additional time entry.
      - `additionalTransactionTypeId` integer, required — Additional pay code except Reg, OT and DT.
      - `punchIn` string — The start time of the day.
      - `punchOut` string — The end time of the day.
      - `unit` number — The number of pay and/or bill units for the time entry. Usually units are hours. Optional when TimeIn and TimeOut is passed.
      - `payRate` number — Pay Rate for the additional pay code. Used if placement is missing setup for additional transaction type.
      - `billRate` number — Bill Rate for the additional pay code. Used if placement is missing setup for additional transaction type.
    - `dayWorkedCalulated` string, date-time
  - `status` string, required — The status of the timesheet. Accepted Values are: Saved, Submitted and Approved.
  - `timeSheetNote` TimeSheetNoteDto
    - `date` string, date-time, required — The Date for the TimeSheet note. This is just a date stamp, no time should be included.
    - `userId` integer, required — The Author for the TimeSheet note.
    - `note` string, required — The note for the TimeSheet.

## Response `201`

The created TimeSheet.

- TimeSheetDto
  - `id` integer — The identifier for the timesheet.
  - `placementId` integer, required — The identifier for the placement. It allows the timesheet to be correlated with the talent to whom the time belongs.
  - `weekWorked` string, date-time, required — The week ending date. This is just a date stamp, no time should be included.
  - `dailyTime` TimeEntryDto[], required — A list of time entries and their details.
    - `dayWorked` string, date-time, required — The date for the time entry. This should be just a date stamp. No time should be included.
    - `timeIn` string — The start time of the day.
    - `timeOut` string — The end time of the day.
    - `breakOut` string — The break start time.
    - `breakIn` string — The break end time.
    - `breakUnit` number — The break unit.
    - `additionalTimeEntry` AdditionalTimeEntryDto[] — List of additional time entry.
      - `additionalTransactionTypeId` integer, required — Additional pay code except Reg, OT and DT.
      - `punchIn` string — The start time of the day.
      - `punchOut` string — The end time of the day.
      - `unit` number — The number of pay and/or bill units for the time entry. Usually units are hours. Optional when TimeIn and TimeOut is passed.
      - `payRate` number — Pay Rate for the additional pay code. Used if placement is missing setup for additional transaction type.
      - `billRate` number — Bill Rate for the additional pay code. Used if placement is missing setup for additional transaction type.
    - `dayWorkedCalulated` string, date-time
  - `status` string, required — The status of the timesheet. Accepted Values are: Saved, Submitted and Approved.
  - `timeSheetNote` TimeSheetNoteDto
    - `date` string, date-time, required — The Date for the TimeSheet note. This is just a date stamp, no time should be included.
    - `userId` integer, required — The Author for the TimeSheet note.
    - `note` string, required — The note for the TimeSheet.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Access Denied
- `404` — Not found
- `405` — Unsupported method
- `406` — Unsupported format(s) indicated by Accept header
- `415` — Unsupported format(s) indicated by the Content-Type header
- `429` — Too many requests
- `500` — An unexpected error occurred
- `502` — Service Unavailable
- `504` — Gateway Timeout

---

[API](https://skmtc.net/avionte/apis/aviont-partner-authorization-api.md) · [All operations](https://skmtc.net/avionte/apis/aviont-partner-authorization-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/avionte/aviont-partner-authorization-api/revisions/846b33e4e71b/schema)