Jobs

Job Custom Fields

Job Custom Fields allow you to store additional, company-specific information against jobs in Timeero.
These fields help extend the default job schema without modifying core job attributes.

Related API Reference

All operations related to jobs—including reading and updating custom fields—are handled through the Jobs API.

👉 Jobs API Reference
GET /api/public/jobs
POST /api/public/jobs
PUT /api/public/jobs/{id}

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

Supported Input Types

Job custom fields support the following input types:

text
textarea
numeric
monetary
dropdown
dropdown_multiselect
checkbox
radio_button
date_picker
time_picker

Creating Job Custom Fields

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

Steps:

Navigate to Settings → Custom Fields
Select Jobs → 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 jobs.

API Representation

Job custom field values are returned under the custom_fields object when retrieving jobs via the API.

Example Response

{
  "name": "Job A",
  "description": "Job A description",
  "street": "Street 1",
  "landmark": "",
  "state": "State 1",
  "city": "City 1",
  "zip_code": "00000",
  "country": "Country",
  "latitude": 26.013501,
  "longitude": -80.3136614,
  "track_mileage": 1,
  "radius": 100,
  "contact_required": 1,
  "contact_name": "Joe",
  "contact_phone": "123456",
  "contact_mobile": null,
  "contact_email": "[email protected]",
  "geofence_members": [],
  "users": [
    1,
    2
  ],
  "custom_fields": {
    "12": "09/02/2025",
    "25": "Job custom field value"
  }
}

Updating Job Custom Fields

Custom fields can be set or updated when creating or updating a job via the Jobs API.

Example Request

curl -H "Authorization: <Access-Token>" \
     -H "Content-Type: application/json" \
     --request PUT \
     --data '{
       "name": "Warehouse Expansion Project",
       "custom_fields": {
          "123": "JOB-2025-001",
          "312": 150000,
          "232": "High",
          "544": "2025-02-01",
          "6433": true
       }
     }' \
     https://api.timeero.app/api/public/jobs/101

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