---
title: "POST timesheet"
method: POST
path: "/v3/administrations/{administration_id}/todos/{todo_id}/timesheets"
tags: ["Todo Timesheets"]
---

# POST timesheet

`POST /v3/administrations/{administration_id}/todos/{todo_id}/timesheets`

## Request

- Base URL: `https://api.bookingexperts.com`
- URL: `https://api.bookingexperts.com/v3/administrations/{administration_id}/todos/{todo_id}/timesheets`
- Auth: one of:
  - API key in header `X-API-KEY`
  - OAuth 2
    - Authorization code: `/oauth/authorize`
    - Token URL: `/oauth/token`
- TypeScript: <https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/docs/v3/administrations/:administration_id/todos/:todo_id/timesheets/post.ts> (a function with typed inputs; its response is checked against the schema)

Add a new timesheet for a Todo

## Path parameters

- `todo_id` string, required
- `administration_id` string, required

## Query parameters

- `fields[timesheet]` string
- `include` string

## Headers

- `Accept-Language` string

## Request body

- object
  - `data` object: A timesheet that has been uploaded as part of a Todo.
    - `type` string: Type
    - `attributes` object: Attributes
      - `date` string, date
      - `hours` integer
      - `minutes` integer
    - `meta` object: Metadata
      - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known.

## Response `200`

TimesheetResponse

- object
  - `data` Timesheet: A timesheet that has been uploaded as part of a Todo.
    - `id` string: ID
    - `type` string: Type
    - `attributes` object: Attributes
      - `date` string, date
      - `hours` integer
      - `minutes` integer
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `relationships` object: Relationships
      - `todo` object
        - `data` object
          - `id` string: todo ID
          - `type` string
          - `meta` object
            - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known.
            - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update.
    - `meta` object: Metadata
      - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known.
  - `included` Todo[]
    - `id` string: ID
    - `type` string: Type
    - `attributes` object: Attributes
      - `deadline` string, date
      - `quantity` integer
      - `name` string, required
      - `description` string
      - `details` string
      - `blocker` boolean: Yields whether this todo blocks check-in
      - `checkable` boolean: Yields whether this todo should be checked after being finished
      - `taxable` boolean: Yields whether this todo is taxable after being checked
      - `urgent` boolean: This will notify the executor of the todo via SMS
      - `checked_at` string, date-time
      - `finished_at` string, date-time
      - `timesheet_hours` number, double: Total time written in hours
      - `automatically_generated` boolean: Returns whether the todo was generated by an Automatic todo.
      - `memo` string: An optional note
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `links` object: Links
      - `self` string: Link to self
      - `url` string: Link to url
    - `relationships` object: Relationships
      - `executor` object
        - `data` object
          - `id` string: executor ID
          - `type` string
          - `meta` object
            - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known.
            - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update.
      - `facility` object
        - `data` object
          - `id` string: facility ID
          - `type` string
          - `meta` object
            - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known.
            - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update.
      - `rentable_identity` object: DEPRECATED use inventory_object instead
        - `data` object
          - `id` string: rentable_identity ID
          - `type` string
          - `meta` object
            - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known.
            - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update.
      - `inventory_object` object
        - `data` object
          - `id` string: inventory_object ID
          - `type` string
          - `meta` object
            - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known.
            - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update.
      - `todo_list` object
        - `data` object
          - `id` string: todo_list ID
          - `type` string
          - `meta` object
            - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known.
            - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update.
      - `reservation` object
        - `data` object
          - `id` string: reservation ID
          - `type` string
          - `meta` object
            - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known.
            - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update.
      - `administration` object
        - `data` object
          - `id` string: administration ID
          - `type` string
          - `meta` object
            - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known.
            - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update.
      - `creator` object
        - `data` object
          - `id` string: creator ID
          - `type` string
          - `meta` object
            - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known.
            - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update.
      - `invoice` object
        - `data` object
          - `id` string: invoice ID
          - `type` string
          - `meta` object
            - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known.
            - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update.
    - `meta` object: Metadata
      - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known.

## Other responses

- `429`: Error
- `default`: Error

---

[API](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3.md) - [All operations](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/revisions/ff81bc4fefa9?raw)