time-clock

Set a complete clocking record in one call

Sets clock-in, clock-out, and optional breaks for the event that best matches the member and the provided time. Supports three input variants:1. TIMESTAMPS (unix ms)2. ISO_DATE (ISO-8601 date time + optional worked hours)3. SHIFT_DATE (date + HH:mm:ss times). Use conflictBehavior to control what happens when clocking already exists. NOTE: event matching uses a ±12-hour window around the date and time specified by in at. If no event AND allowCreateUnplannedShift is true, a new shift will be created.

post/v1/public/time-clock/set

Request body

memberCodestring required

Employee code

conflictBehavior'THROW_EXCEPTION' | 'THROW_EXCEPTION_ONLY_IF_SET_BY_EMPLOYEE' | 'OVERRIDE'

What to do when the matched event already has an existing clocking data. Default: THROW_EXCEPTION.

allowCreateUnplannedShiftboolean

When true, an unplanned shift is created if no shift exists near the requested start date and time. If false, an exception is thrown.

teamIdstring

The ID of the team used to match or assign a team to the shift.

If provided: The system looks for a corresponding shift under this team. If none exists, the new shift is linked to this team.

If omitted, the system applies these fallback rules:

Primary Team: Uses the member's primary team (if set).
Single Team: If no primary team is set, but the member belongs to exactly one team, that team is used.
Validation Error: If the member has multiple teams (and no primary), you must explicitly specify a team.

teamCodestring

An optional team, referred by code. See teamId for more details

locationIdstring

The ID of the location used to match or assign a location to the shift.

If provided: The system looks for a corresponding shift under this location. If none exists, the new shift is linked to this location.

If omitted, the system applies these fallback rules:

Primary Location: Uses the member's primary location (if set).
Single Location: If no primary location is set, but the member belongs to exactly one location, that location is used.
Validation Error: If the member has multiple locations (and no primary), you must explicitly specify a location.

locationCodestring

An optional location, referred by code. See locationId for more details

skillIdstring

The ID of the skill used to match or assign a skill to the shift.

If provided: The system looks for a corresponding shift under this skill. If none exists, the new shift is linked to this skill.

If omitted, the system applies these fallback rules:

Primary Skill: Uses the member's primary skill (if set).
Single Skill: If no primary skill is set, but the member belongs to exactly one skill, that skill is used.
Validation Error: If the member has multiple skill (and no primary), you must explicitly specify a skill.

skillCodestring

An optional skill, referred by code. See skillId for more details

variant'TIMESTAMPS' | 'ISO_DATE' | 'SHIFT_DATE' required

inAtnumber

[TIMESTAMPS] Clock-in unix timestamp in ms

outAtnumber

[TIMESTAMPS] Clock-out unix timestamp in ms

startDatestring

[ISO_DATE] Clock-in — ISO-8601 datetime

endDatestring

[ISO_DATE] Clock-out — ISO-8601 datetime

workedHoursnumber

[ISO_DATE / SHIFT_DATE] Total paid hours. Mutually exclusive with unpaidBreakMinutes.

unpaidBreakMinutesnumber

Total unpaid break in minutes. Mutually exclusive with workedHours.

shiftDatestring

[SHIFT_DATE] Date of the shift — YYYY-MM-DD

startTimestring

[SHIFT_DATE] Clock-in time — HH:mm:ss (24h)

endTimestring

[SHIFT_DATE] Clock-out time — HH:mm:ss (24h). Next day inferred when < startTime.

timeZonestring

[SHIFT_DATE] When using SHIFT_DATE mode the shiftDate time zone cannot be determined. You should provide one. If none is provided, the company time zone is used.

Response

uidstring required

unique event id

externalIdstring

The unique event externalId. The externalId is often used as a mapping value between Evolia and an external system

startsAtstring required

date and time of the start of the event. In ISO-8601 format.

endsAtstring required

date and time of the end of the event. In ISO-8601 format.

hideEndsAtboolean required

if true the event has an undetermined end time. endsAt is still initialised but represent more a suggested end time

timeZonestring required

event time zone, ex: America/New_York

memberFirstNamestring

when assigned, contains the member (employee) first name

memberLastNamestring

when assigned, contains the member (employee) first name

memberIdstring

when assigned, contains the member (employee) UID

memberCodestring

when assigned, contains the member (employee) code

memberHourlyWagenumber

when assigned, contains the member hourly wage specific to the skill of the shift

openShiftCountnumber

a shift is considered open when memberId is undefined. When a shift is open, openShiftCount indicates the number of places available

skillIdstring required

the event skill UID (position)

skillNamestring required

the event skill name (position)

skillCodestring

the event skill code (position)

locationIdstring

the event location UID

locationNamestring

the event location name

locationCodestring

the event location code

subLocationIdstring

the event sub-location UID

subLocationNamestring

the event sub-location name

subLocationCodestring

the event sub-location code

divisionIdstring

the event division UID

teamIdstring required

the event team UID

teamCodestring

the event team code

teamNamestring

the event team name

isStandbyboolean

if true this event is in stand-by

isCancelledboolean

if true this event is cancelled

cancelledReasonstring

the reason of the cancellation

isDraftboolean required

if true this event is draft

notestring

This note is visible to the assigned employee and to shift team managers

internalNotestring

The internalNote field is a private property restricted to shift team managers. This information is never visible to the assigned employee.

paidPreparationTimeInMnumber required

The paid preparation time in minutes.

assignedByobject required

when assigned, member (employee) UID that assigned the event.

assignedAtstring required

when assigned, date and time of the assignment of the event. In ISO-8601 format.

splitFromEventIdstring required

when event is split from another event, contains the source event UID

Example response

{
  "premiums": [
    {
      "names": {
        "en": "night bonus",
        "fr": "prime de nuit"
      },
      "calculationType": "AMOUNT: flat amount (+ 15$), HOURS: flat amount of hours (+ 1h), HOURLY_MULTIPLIER: multiply hourly rate (x 1.5/h), HOURLY_BONUS: flat hourly bonus (+ 1$/h)",
      "code": "241"
    }
  ]
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.