Automatic clock-in or clock-out based on current status

curl --request POST \ --url https://api-{region}.sesametime.com/schedule/v1/work-entries/clock \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "employeeId": "550e8400-e29b-41d4-a716-446655440000" } '

{ "data": { "id": "770e8400-e29b-41d4-a716-446655440000", "workCheckTypeId": null, "employee": { "id": "550e8400-e29b-41d4-a716-446655440000", "firstName": "John", "lastName": "Doe" }, "workEntryType": "work", "workEntryIn": { "origin": "api", "date": "2025-01-26T09:00:00+01:00", "coordinates": { "latitude": 40.7128, "longitude": -74.006 }, "officeId": null }, "workEntryOut": null, "hasIncidence": false, "workedSeconds": 0, "createdAt": "2025-01-26T09:00:00+01:00", "updatedAt": "2025-01-26T09:00:00+01:00", "deletedAt": null }, "meta": {} }

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Clock request data

employeeId

string<uuid>

required

The employee's unique identifier

workEntryIn

object

Entry data (coordinates)

Show child attributes

workCheckTypeId

string<uuid> | null

Work check type ID (only applies to clock-in). Must be assigned to the employee.

workBreakId

string<uuid> | null

Work break ID for pause entries (only applies to clock-in)

withIncidence

boolean

default:false

If true and a clock-out is performed, creates an incidence of type 'closed_api'. The employee will be notified about this incidence. Useful for closing entries that were open from previous days.

Response

Clock action performed successfully

data

object

Work entry data

Show child attributes