Create a timesheet

POST 
/api/timesheets

Required permissions:

• timetracking.view: allows to create resources.

Here the dedicated support page.

Request

Header Parameters

Wethod-Company stringrequired

The company you want to interact with

Wethod-Version stringrequired

The API version you want to use

application/json

Body

date daterequired

The date of the timesheet (must be a Monday).

day stringrequired

The day of the week (mon, tue, wed, thu, fri, sat, sun).

hours floatrequired

The number of hours worked.

notes string

Optional notes for the timesheet.

project_id integerrequired

The ID of the project.

person_id integerrequired

The ID of the person.

Responses

201

Returns the created timesheet.

application/json

Schema

Schema

id integerrequired

Possible values: >= 1

The unique identifier of the resource

created_at date-timerequired

The date and time when the resource was created

updated_at date-timerequired

The date and time when the resource was last updated

date daterequired

The date of the timesheet

hours floatrequired

The daily hours of the timesheet

notes string

Notes of the timesheet

mode stringrequired

The mode of the timesheet

project_id integerrequired

Possible values: >= 1

ID of the project related to the timesheet

person_id integerrequired

Possible values: >= 1

ID of the person related to the timesheet

deleted_at date-time

Example (from schema)

{
  "id": 1,
  "created_at": "2025-06-06T13:37:11.357Z",
  "updated_at": "2025-06-06T13:37:11.357Z",
  "date": "2024-01-01",
  "hours": 15.6,
  "notes": "This is a note",
  "mode": "daily",
  "project_id": 1,
  "person_id": 1,
  "deleted_at": "2025-06-06T13:37:11.357Z"
}

400

Validation failed

application/json

Schema

Schema

key string

Error unique key

message string

Human-readable message describing the error

failures

object[]

List of validation errors

Array [

field string

Name of the field causing the error

message string

Human-readable description of the error

]

Example (from schema)

{
  "key": "invalid_data",
  "message": "You provided invalid data. Check 'failures' for details.",
  "failures": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}

401

Unauthorized

application/json

Schema

Schema

key string

Error unique key

message string

Human-readable message describing the error

Example (from schema)

{
  "key": "string",
  "message": "string"
}

403

Forbidden

application/json

Schema

Schema

key string

Error unique key

message string

Human-readable message describing the error

Example (from schema)

{
  "key": "string",
  "message": "string"
}

Loading...