Create Configuration

post

https://{companyDomain}.bamboohr.com/api/v1/time-tracking/configurations

Creates a new GROUP time tracking configuration together with its approval workflow. The type is forced to GROUP server-side; the GLOBAL configuration is auto-managed and cannot be created via this endpoint. Accepts an optional Idempotency-Key header for safe retries.

OAuth Scopes: time_tracking:configurations.write

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Request body for creating a GROUP time tracking configuration. The GLOBAL configuration is auto-managed and cannot be created here.

name

string

required

length between 1 and 255

The configuration name. Unique per company.

timesheetType

string

enum

required

How time is logged.

Allowed:

workWeekStartsOn

string

enum

required

Day of week the work week starts.

Allowed:

approverType

string

enum

required

Who approves timesheets.

Allowed:

approverUserId

The user ID of the approver. Required when approverType is SPECIFIC_PERSON; must be omitted otherwise.

approvalCutoff

string

required

Time of day by which timesheets must be approved, in 24-hour HH:MM format.

approvalCutoffDays

integer

required

0 to 5

Number of days before the pay date the cutoff applies.

clockInSchedulePolicy

string

enum

Defaults to ANYTIME

When scheduled employees can clock in.

Allowed:

restrictWebClockActions

boolean

Defaults to false

When true, removes the time clock from bamboohr.com for employees in this configuration.

mobileEnabled

boolean

Defaults to false

When true, employees can log time using the BambooHR mobile app.

geolocationEnabled

boolean

Defaults to false

When true, employee location is required when clocking in/out via mobile. Stored but has no effect while mobileEnabled is false.

customOvertimeEnabled

boolean

Defaults to false

When true, the overtime threshold fields are honored. When false, they must be omitted.

overtimeDailyHours

Daily overtime threshold in hours. Only allowed when customOvertimeEnabled is true. Decimal string with at most 2 decimals, at least 1 and less than 24.

overtimeDailyDoubleHours

Daily double-overtime threshold in hours. Only allowed when customOvertimeEnabled is true. Decimal string with at most 2 decimals, at least 1 and less than 24.

overtimeWeeklyHours

Weekly overtime threshold in hours. Only allowed when customOvertimeEnabled is true. Decimal string with at most 2 decimals, at least 1 and less than 169.

Headers

Idempotency-Key

string

Optional client-supplied key for safe retries (UUID recommended). Replaying the same key returns the original response; reusing it with a different body returns 409.

Responses

Language

Credentials

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Configuration created successfully.

400Malformed request body.

401Unauthorized. Missing or invalid authentication.

403Forbidden. Insufficient permissions.

409Conflict. A configuration with this name already exists, or the Idempotency-Key was reused with a different body.

422Validation error (e.g., missing required field, missing approverUserId when required, overtime fields set while customOvertimeEnabled is false, an overtime threshold outside its allowed range, or attempting to create a GLOBAL configuration).