Your browser is not up to date. This may cause security, speed, and display
issues. Please update your browser.
Update Browser
X
Clockodo API:
Manage co-workers
New API documentation
Feel free to use our updated API documentation.
Object type "user"
| Parameter | Type | Description |
|---|---|---|
| id | integer |
ID of the co-worker
|
| name | string |
Name of the co-worker
|
| number | string|null |
Personnel number
|
| string |
E-mail-address of the co-worker
| |
| role | string |
Role of the co-worker
|
| active | boolean |
Is the co-worker active?
|
| timeformat_12h | boolean |
Is the co-worker using the 12h time format?
|
| weekstart_monday | boolean |
Does the week start on Monday for the co-worker?
If not, the week starts on Sunday
|
| weekend_friday | boolean |
Is the weekend Friday and Saturday for the co-worker?
If not, it is Saturday and Sunday
|
| language | string |
The co-worker's language
Allowed values: 'de', 'en', 'fr'
|
| timezone | string |
The co-worker's timezone
e.g. 'Europe/Berlin'
|
| wage_type | integer|null |
Only relevant for the DATEV export
Allowed values: 1 (salary), 2 (hourly wage)
|
| can_generally_see_absences | boolean |
Only editable for co-workers with the role 'worker'
Nur änderbar für Mitarbeiter mit der Rolle 'worker'
|
| can_generally_manage_absences | boolean |
Is the co-worker allowed to edit other co-workers' absences?
Only editable for co-workers with the role 'manager'
|
| can_add_customers | boolean |
Is the co-worker allowed to add customers?
Only editable for co-workers with the role 'worker'
|
| edit_lock | string|null |
Fixed edit lock for this co-worker
null (No edit lock) YYYY-MM-DD (Not editable until) |
| edit_lock_dyn | integer|null |
Dynamic edit lock for this co-worker
null (No edit lock) 1 (Today editable) 2 (Today and yesterday editable) 3 (Today and 2 days retroactively editable) 5 (Today and 4 days retroactively editable) 8 (Today and one week retroactively editable) 15 (Today and 2 weeks retroactively editable) 31 (Today and 30 days retroactively editable) 46 (Today and 45 days retroactively editable) 91 (Today and 90 days retroactively editable) |
| edit_lock_sync | boolean|null |
Can future changes to the company-wide edit lock overwrite the edit lock for this co-worker?
|
| worktime_regulation_id | integer|null |
The worktime regulation applicable to the co-worker
"0" if the co-worker has no worktime regulation "null" if the company default is applicable |
| teams_id | integer|null |
ID of the team that the co-worker is assigned to
|
| initials | string|null |
The co-worker's initials
|
| nonbusinessgroups_id | integer|null |
ID of the co-worker's nonbusiness group
deprecated; use v2/usersNonbusinessGroups instead
|
| boss | integer|null |
ID of the user's boss
|
| absence_managers_id | integer[] |
IDs of the users that are absence managers for this user
|
List co-workers
Request
GET /api/v2/users
Response
{
"users":
{
[object of type user],
[object of type user], ...
}
}Get co-worker
Request
GET /api/v2/users/[ID]
Response
{
"user": [object of type user]
}Add co-workers
Request
POST /api/v2/users
| Required parameters | name, email, role |
|---|
| Optional parameters | mail_to_user, number, timeformat_12h, weekstart_monday, weekend_friday, language, timezone, wage_type, can_generally_see_absences, can_generally_manage_absences, can_add_customers, edit_lock_sync, teams_id, nonbusinessgroups_id, worktime_regulation_id, boss |
|---|
The parameter mail_to_user determines whether an e-mail should be sent to the new co-worker (default: false).
Response
{
"user": [object of type user]
}Edit co-workers
Request
PUT /api/v2/users/[ID]
| Required parameters | none |
|---|
| Optional parameters | name, number, active, role, timeformat_12h, weekstart_monday, weekend_friday, language, timezone, wage_type, can_generally_see_absences, can_generally_manage_absences, can_add_customers, edit_lock, edit_lock_dyn, edit_lock_sync, teams_id, nonbusinessgroups_id, worktime_regulation_id, boss |
|---|
The timezone can only be changed for the company creator, and only during the trial phase.
Response
{
"user": [object of type user]
}Delete co-workers
Request
DELETE /api/v2/users/[ID]
Response
{
"success": true
}