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": {}
}Automatic clock-in or clock-out based on current status
Performs an automatic clock-in if no open work entry exists, or clock-out if there’s an open work entry. When closing with withIncidence: true, creates an incidence alert for the employee (useful for entries open from previous days).
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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Clock request data
The employee's unique identifier
Entry data (coordinates)
Show child attributes
Show child attributes
Work check type ID (only applies to clock-in). Must be assigned to the employee.
Work break ID for pause entries (only applies to clock-in)
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.
Was this page helpful?