Timesheets

Timesheet Custom Fields

Timesheet Custom Fields allow you to capture additional, company-specific data for time entries in Timeero.
These fields are useful for tracking metadata such as work type, approval references, location details, or internal notes.

Custom fields are currently supported for Timesheets.

Related API Reference

All timesheet operations—including reading and updating custom fields—are handled through the Timesheets API.

👉 Timesheets API Reference
GET /api/public/timesheets
POST /api/public/timesheets
PUT /api/public/timesheets/{id}

For full request and response schemas, refer to:
Timesheets API Reference

Supported Input Types

Timesheet custom fields support the following input types:

text
textarea
numeric
monetary
dropdown
dropdown_multiselect
checkbox
radio_button
date_picker
time_picker

Creating Timesheet Custom Fields

Timesheet custom fields are created and managed via the Timeero web application.

Steps:

Navigate to Settings → Custom Fields
Select Time & Mileage → Configure Fields as the resource type
Click Add Custom Field
Choose an input type and configure options
Save the field

Once created, the field becomes available for all timesheet entries.

API Representation

Timesheet custom field values are returned under the custom_fields object when retrieving timesheets via the API.

Example Response

{
  "user_id": 1,
  "job_id": 5102,
  "mileage": 10,
  "notes": "",
  "start": "2024-10-24T08:10:48+07:00",
  "end": null,
  "clock_in_timezone": "America/Los_Angeles",
  "clock_out_timezone": null,
  "custom_fields": {
    "id": "custom field value"
  }
}

Creating or Updating Timesheet Custom Fields

Custom field values can be provided when creating or updating a timesheet via the API.

Example Request

curl -H "Authorization: <Access-Token>" \
     -H "Content-Type: application/json" \
     --request PUT \
     --data '{
        "user_id": 1,
        "job_id": 5102,
        "mileage": 10,
        "notes": "",
        "start": "2024-10-24T08:10:48+07:00",
        "end": null,
        "clock_in_timezone": "America/Los_Angeles",
        "clock_out_timezone": null,
        "custom_fields": {
           "123": "Overtime",
           "423": "On-site",
           "342": true,
           "43232": 35.50,
           "4323": "2025-02-10"
         }
     }' \
     https://api.timeero.app/api/public/timesheets/8452

Validation Rules

Values must conform to the configured input type
Dropdown and radio fields only accept predefined options
Numeric and monetary fields accept numbers only
Date and time fields must follow supported formats