---
title: "POST /v3/users"
method: POST
path: "/v3/users"
tags: ["User"]
---

# POST /v3/users

`POST /v3/users`

## Request body

- object
  - `email` string, email, required
  - `name` string, required
  - `role` 'worker' | 'owner', required — Possible values: - `worker`: Worker - `owner`: Administrator
  - `active` boolean
  - `boss` integer, nullable
  - `number` string, nullable
  - `language` 'en' | 'fr' | 'de' — Possible values: - `en`: English - `fr`: French - `de`: German
  - `teams_id` integer, nullable
  - `timeformat_12h` boolean — Use 12h time format?
  - `timezone` 'Africa/Abidjan' | 'Africa/Accra' | 'Africa/Addis_Ababa' | 'Africa/Algiers' | 'Africa/Asmara' | 'Africa/Bamako' | 'Africa/Bangui' | 'Africa/Banjul' | 'Africa/Bissau' | 'Africa/Blantyre' | 'Africa/Brazzaville' | 'Africa/Bujumbura' | 'Africa/Cairo' | 'Africa/Casablanca' | 'Africa/Ceuta' | 'Africa/Conakry' | 'Africa/Dakar' | 'Africa/Dar_es_Salaam' | 'Africa/Djibouti' | 'Africa/Douala' | 'Africa/El_Aaiun' | 'Africa/Freetown' | 'Africa/Gaborone' | 'Africa/Harare' | 'Africa/Johannesburg' | 'Africa/Juba' | 'Africa/Kampala' | 'Africa/Khartoum' | 'Africa/Kigali' | 'Africa/Kinshasa' | 'Africa/Lagos' | 'Africa/Libreville' | 'Africa/Lome' | 'Africa/Luanda' | 'Africa/Lubumbashi' | 'Africa/Lusaka' | 'Africa/Malabo' | 'Africa/Maputo' | 'Africa/Maseru' | 'Africa/Mbabane' | 'Africa/Mogadishu' | 'Africa/Monrovia' | 'Africa/Nairobi' | 'Africa/Ndjamena' | 'Africa/Niamey' | 'Africa/Nouakchott' | 'Africa/Ouagadougou' | 'Africa/Porto-Novo' | 'Africa/Tripoli' | 'Africa/Tunis' | 'Africa/Windhoek' | 'America/Adak' | 'America/Anchorage' | 'America/Anguilla' | 'America/Antigua' | 'America/Araguaina' | 'America/Argentina/Buenos_Aires' | 'America/Argentina/Catamarca' | 'America/Argentina/Cordoba' | 'America/Argentina/Jujuy' | 'America/Argentina/La_Rioja' | 'America/Argentina/Mendoza' | 'America/Argentina/Rio_Gallegos' | 'America/Argentina/Salta' | 'America/Argentina/San_Juan' | 'America/Argentina/San_Luis' | 'America/Argentina/Tucuman' | 'America/Argentina/Ushuaia' | 'America/Aruba' | 'America/Asuncion' | 'America/Atikokan' | 'America/Bahia' | 'America/Bahia_Banderas' | 'America/Barbados' | 'America/Belem' | 'America/Belize' | 'America/Blanc-Sablon' | 'America/Boa_Vista' | 'America/Bogota' | 'America/Boise' | 'America/Cambridge_Bay' | 'America/Campo_Grande' | 'America/Cancun' | 'America/Caracas' | 'America/Cayenne' | 'America/Cayman' | 'America/Chicago' | 'America/Chihuahua' | 'America/Costa_Rica' | 'America/Creston' | 'America/Cuiaba' | 'America/Curacao' | 'America/Danmarkshavn' | 'America/Dawson' | 'America/Dawson_Creek' | 'America/Denver' | 'America/Detroit' | 'America/Dominica' | 'America/Edmonton' | 'America/Eirunepe' | 'America/El_Salvador' | 'America/Fort_Nelson' | 'America/Fortaleza' | 'America/Glace_Bay' | 'America/Goose_Bay' | 'America/Grand_Turk' | 'America/Grenada' | 'America/Guadeloupe' | 'America/Guatemala' | 'America/Guayaquil' | 'America/Guyana' | 'America/Halifax' | 'America/Havana' | 'America/Hermosillo' | 'America/Indiana/Indianapolis' | 'America/Indiana/Knox' | 'America/Indiana/Marengo' | 'America/Indiana/Petersburg' | 'America/Indiana/Tell_City' | 'America/Indiana/Vevay' | 'America/Indiana/Vincennes' | 'America/Indiana/Winamac' | 'America/Inuvik' | 'America/Iqaluit' | 'America/Jamaica' | 'America/Juneau' | 'America/Kentucky/Louisville' | 'America/Kentucky/Monticello' | 'America/Kralendijk' | 'America/La_Paz' | 'America/Lima' | 'America/Los_Angeles' | 'America/Lower_Princes' | 'America/Maceio' | 'America/Managua' | 'America/Manaus' | 'America/Marigot' | 'America/Martinique' | 'America/Matamoros' | 'America/Mazatlan' | 'America/Menominee' | 'America/Merida' | 'America/Mexico_City' | 'America/Miquelon' | 'America/Moncton' | 'America/Monterrey' | 'America/Montevideo' | 'America/Montserrat' | 'America/Nassau' | 'America/New_York' | 'America/Nome' | 'America/Noronha' | 'America/North_Dakota/Beulah' | 'America/North_Dakota/Center' | 'America/North_Dakota/New_Salem' | 'America/Ojinaga' | 'America/Panama' | 'America/Paramaribo' | 'America/Phoenix' | 'America/Port-au-Prince' | 'America/Port_of_Spain' | 'America/Porto_Velho' | 'America/Puerto_Rico' | 'America/Punta_Arenas' | 'America/Rankin_Inlet' | 'America/Recife' | 'America/Regina' | 'America/Resolute' | 'America/Rio_Branco' | 'America/Santarem' | 'America/Santiago' | 'America/Santo_Domingo' | 'America/Sao_Paulo' | 'America/Scoresbysund' | 'America/Sitka' | 'America/St_Barthelemy' | 'America/St_Johns' | 'America/St_Kitts' | 'America/St_Lucia' | 'America/St_Thomas' | 'America/St_Vincent' | 'America/Swift_Current' | 'America/Tegucigalpa' | 'America/Thule' | 'America/Tijuana' | 'America/Toronto' | 'America/Tortola' | 'America/Vancouver' | 'America/Whitehorse' | 'America/Winnipeg' | 'America/Yakutat' | 'Antarctica/Davis' | 'Antarctica/DumontDUrville' | 'Antarctica/Macquarie' | 'Antarctica/Mawson' | 'Antarctica/McMurdo' | 'Antarctica/Palmer' | 'Antarctica/Rothera' | 'Antarctica/Syowa' | 'Arctic/Longyearbyen' | 'Asia/Aden' | 'Asia/Almaty' | 'Asia/Amman' | 'Asia/Anadyr' | 'Asia/Aqtau' | 'Asia/Aqtobe' | 'Asia/Ashgabat' | 'Asia/Atyrau' | 'Asia/Baghdad' | 'Asia/Bahrain' | 'Asia/Baku' | 'Asia/Bangkok' | 'Asia/Barnaul' | 'Asia/Beirut' | 'Asia/Bishkek' | 'Asia/Brunei' | 'Asia/Chita' | 'Asia/Colombo' | 'Asia/Damascus' | 'Asia/Dhaka' | 'Asia/Dili' | 'Asia/Dubai' | 'Asia/Dushanbe' | 'Asia/Gaza' | 'Asia/Hebron' | 'Asia/Ho_Chi_Minh' | 'Asia/Hong_Kong' | 'Asia/Hovd' | 'Asia/Irkutsk' | 'Asia/Jakarta' | 'Asia/Jayapura' | 'Asia/Jerusalem' | 'Asia/Kabul' | 'Asia/Kamchatka' | 'Asia/Karachi' | 'Asia/Kathmandu' | 'Asia/Khandyga' | 'Asia/Kolkata' | 'Asia/Krasnoyarsk' | 'Asia/Kuala_Lumpur' | 'Asia/Kuching' | 'Asia/Kuwait' | 'Asia/Macau' | 'Asia/Magadan' | 'Asia/Makassar' | 'Asia/Manila' | 'Asia/Muscat' | 'Asia/Nicosia' | 'Asia/Novokuznetsk' | 'Asia/Novosibirsk' | 'Asia/Omsk' | 'Asia/Oral' | 'Asia/Phnom_Penh' | 'Asia/Pontianak' | 'Asia/Pyongyang' | 'Asia/Qatar' | 'Asia/Qostanay' | 'Asia/Riyadh' | 'Asia/Sakhalin' | 'Asia/Samarkand' | 'Asia/Seoul' | 'Asia/Shanghai' | 'Asia/Singapore' | 'Asia/Srednekolymsk' | 'Asia/Taipei' | 'Asia/Tashkent' | 'Asia/Tbilisi' | 'Asia/Tehran' | 'Asia/Thimphu' | 'Asia/Tokyo' | 'Asia/Tomsk' | 'Asia/Ulaanbaatar' | 'Asia/Urumqi' | 'Asia/Ust-Nera' | 'Asia/Vientiane' | 'Asia/Vladivostok' | 'Asia/Yakutsk' | 'Asia/Yangon' | 'Asia/Yekaterinburg' | 'Asia/Yerevan' | 'Atlantic/Azores' | 'Atlantic/Bermuda' | 'Atlantic/Canary' | 'Atlantic/Cape_Verde' | 'Atlantic/Faroe' | 'Atlantic/Madeira' | 'Atlantic/Reykjavik' | 'Atlantic/South_Georgia' | 'Atlantic/St_Helena' | 'Atlantic/Stanley' | 'Australia/Adelaide' | 'Australia/Brisbane' | 'Australia/Broken_Hill' | 'Australia/Darwin' | 'Australia/Eucla' | 'Australia/Hobart' | 'Australia/Lindeman' | 'Australia/Lord_Howe' | 'Australia/Melbourne' | 'Australia/Perth' | 'Australia/Sydney' | 'Europe/Amsterdam' | 'Europe/Andorra' | 'Europe/Astrakhan' | 'Europe/Athens' | 'Europe/Belgrade' | 'Europe/Berlin' | 'Europe/Bratislava' | 'Europe/Brussels' | 'Europe/Bucharest' | 'Europe/Budapest' | 'Europe/Busingen' | 'Europe/Chisinau' | 'Europe/Copenhagen' | 'Europe/Dublin' | 'Europe/Gibraltar' | 'Europe/Guernsey' | 'Europe/Helsinki' | 'Europe/Isle_of_Man' | 'Europe/Istanbul' | 'Europe/Jersey' | 'Europe/Kaliningrad' | 'Europe/Kirov' | 'Europe/Kyiv' | 'Europe/Lisbon' | 'Europe/Ljubljana' | 'Europe/London' | 'Europe/Luxembourg' | 'Europe/Madrid' | 'Europe/Malta' | 'Europe/Mariehamn' | 'Europe/Minsk' | 'Europe/Monaco' | 'Europe/Moscow' | 'Europe/Oslo' | 'Europe/Paris' | 'Europe/Podgorica' | 'Europe/Prague' | 'Europe/Riga' | 'Europe/Rome' | 'Europe/Samara' | 'Europe/San_Marino' | 'Europe/Sarajevo' | 'Europe/Saratov' | 'Europe/Simferopol' | 'Europe/Skopje' | 'Europe/Sofia' | 'Europe/Stockholm' | 'Europe/Tallinn' | 'Europe/Tirane' | 'Europe/Ulyanovsk' | 'Europe/Vaduz' | 'Europe/Vatican' | 'Europe/Vienna' | 'Europe/Vilnius' | 'Europe/Volgograd' | 'Europe/Warsaw' | 'Europe/Zagreb' | 'Europe/Zurich' | 'Indian/Antananarivo' | 'Indian/Chagos' | 'Indian/Christmas' | 'Indian/Cocos' | 'Indian/Comoro' | 'Indian/Kerguelen' | 'Indian/Mahe' | 'Indian/Maldives' | 'Indian/Mauritius' | 'Indian/Mayotte' | 'Indian/Reunion' | 'Pacific/Apia' | 'Pacific/Auckland' | 'Pacific/Bougainville' | 'Pacific/Chatham' | 'Pacific/Chuuk' | 'Pacific/Easter' | 'Pacific/Efate' | 'Pacific/Fakaofo' | 'Pacific/Fiji' | 'Pacific/Funafuti' | 'Pacific/Galapagos' | 'Pacific/Gambier' | 'Pacific/Guadalcanal' | 'Pacific/Guam' | 'Pacific/Honolulu' | 'Pacific/Kiritimati' | 'Pacific/Kosrae' | 'Pacific/Kwajalein' | 'Pacific/Majuro' | 'Pacific/Marquesas' | 'Pacific/Midway' | 'Pacific/Nauru' | 'Pacific/Niue' | 'Pacific/Norfolk' | 'Pacific/Noumea' | 'Pacific/Pago_Pago' | 'Pacific/Palau' | 'Pacific/Pitcairn' | 'Pacific/Pohnpei' | 'Pacific/Port_Moresby' | 'Pacific/Rarotonga' | 'Pacific/Saipan' | 'Pacific/Tahiti' | 'Pacific/Tarawa' | 'Pacific/Tongatapu' | 'Pacific/Wake' | 'Pacific/Wallis' | 'UTC' — Possible values: - `Africa/Abidjan`: AfricaAbidjan - `Africa/Accra`: AfricaAccra - `Africa/Addis_Ababa`: AfricaAddisAbaba - `Africa/Algiers`: AfricaAlgiers - `Africa/Asmara`: AfricaAsmara - `Africa/Bamako`: AfricaBamako - `Africa/Bangui`: AfricaBangui - `Africa/Banjul`: AfricaBanjul - `Africa/Bissau`: AfricaBissau - `Africa/Blantyre`: AfricaBlantyre - `Africa/Brazzaville`: AfricaBrazzaville - `Africa/Bujumbura`: AfricaBujumbura - `Africa/Cairo`: AfricaCairo - `Africa/Casablanca`: AfricaCasablanca - `Africa/Ceuta`: AfricaCeuta - `Africa/Conakry`: AfricaConakry - `Africa/Dakar`: AfricaDakar - `Africa/Dar_es_Salaam`: AfricaDarEsSalaam - `Africa/Djibouti`: AfricaDjibouti - `Africa/Douala`: AfricaDouala - `Africa/El_Aaiun`: AfricaElAaiun - `Africa/Freetown`: AfricaFreetown - `Africa/Gaborone`: AfricaGaborone - `Africa/Harare`: AfricaHarare - `Africa/Johannesburg`: AfricaJohannesburg - `Africa/Juba`: AfricaJuba - `Africa/Kampala`: AfricaKampala - `Africa/Khartoum`: AfricaKhartoum - `Africa/Kigali`: AfricaKigali - `Africa/Kinshasa`: AfricaKinshasa - `Africa/Lagos`: AfricaLagos - `Africa/Libreville`: AfricaLibreville - `Africa/Lome`: AfricaLome - `Africa/Luanda`: AfricaLuanda - `Africa/Lubumbashi`: AfricaLubumbashi - `Africa/Lusaka`: AfricaLusaka - `Africa/Malabo`: AfricaMalabo - `Africa/Maputo`: AfricaMaputo - `Africa/Maseru`: AfricaMaseru - `Africa/Mbabane`: AfricaMbabane - `Africa/Mogadishu`: AfricaMogadishu - `Africa/Monrovia`: AfricaMonrovia - `Africa/Nairobi`: AfricaNairobi - `Africa/Ndjamena`: AfricaNdjamena - `Africa/Niamey`: AfricaNiamey - `Africa/Nouakchott`: AfricaNouakchott - `Africa/Ouagadougou`: AfricaOuagadougou - `Africa/Porto-Novo`: AfricaPortoNovo - `Africa/Tripoli`: AfricaTripoli - `Africa/Tunis`: AfricaTunis - `Africa/Windhoek`: AfricaWindhoek - `America/Adak`: AmericaAdak - `America/Anchorage`: AmericaAnchorage - `America/Anguilla`: AmericaAnguilla - `America/Antigua`: AmericaAntigua - `America/Araguaina`: AmericaAraguaina - `America/Argentina/Buenos_Aires`: AmericaArgentinaBuenosAires - `America/Argentina/Catamarca`: AmericaArgentinaCatamarca - `America/Argentina/Cordoba`: AmericaArgentinaCordoba - `America/Argentina/Jujuy`: AmericaArgentinaJujuy - `America/Argentina/La_Rioja`: AmericaArgentinaLaRioja - `America/Argentina/Mendoza`: AmericaArgentinaMendoza - `America/Argentina/Rio_Gallegos`: AmericaArgentinaRioGallegos - `America/Argentina/Salta`: AmericaArgentinaSalta - `America/Argentina/San_Juan`: AmericaArgentinaSanJuan - `America/Argentina/San_Luis`: AmericaArgentinaSanLuis - `America/Argentina/Tucuman`: AmericaArgentinaTucuman - `America/Argentina/Ushuaia`: AmericaArgentinaUshuaia - `America/Aruba`: AmericaAruba - `America/Asuncion`: AmericaAsuncion - `America/Atikokan`: AmericaAtikokan - `America/Bahia`: AmericaBahia - `America/Bahia_Banderas`: AmericaBahiaBanderas - `America/Barbados`: AmericaBarbados - `America/Belem`: AmericaBelem - `America/Belize`: AmericaBelize - `America/Blanc-Sablon`: AmericaBlancSablon - `America/Boa_Vista`: AmericaBoaVista - `America/Bogota`: AmericaBogota - `America/Boise`: AmericaBoise - `America/Cambridge_Bay`: AmericaCambridgeBay - `America/Campo_Grande`: AmericaCampoGrande - `America/Cancun`: AmericaCancun - `America/Caracas`: AmericaCaracas - `America/Cayenne`: AmericaCayenne - `America/Cayman`: AmericaCayman - `America/Chicago`: AmericaChicago - `America/Chihuahua`: AmericaChihuahua - `America/Costa_Rica`: AmericaCostaRica - `America/Creston`: AmericaCreston - `America/Cuiaba`: AmericaCuiaba - `America/Curacao`: AmericaCuracao - `America/Danmarkshavn`: AmericaDanmarkshavn - `America/Dawson`: AmericaDawson - `America/Dawson_Creek`: AmericaDawsonCreek - `America/Denver`: AmericaDenver - `America/Detroit`: AmericaDetroit - `America/Dominica`: AmericaDominica - `America/Edmonton`: AmericaEdmonton - `America/Eirunepe`: AmericaEirunepe - `America/El_Salvador`: AmericaElSalvador - `America/Fort_Nelson`: AmericaFortNelson - `America/Fortaleza`: AmericaFortaleza - `America/Glace_Bay`: AmericaGlaceBay - `America/Goose_Bay`: AmericaGooseBay - `America/Grand_Turk`: AmericaGrandTurk - `America/Grenada`: AmericaGrenada - `America/Guadeloupe`: AmericaGuadeloupe - `America/Guatemala`: AmericaGuatemala - `America/Guayaquil`: AmericaGuayaquil - `America/Guyana`: AmericaGuyana - `America/Halifax`: AmericaHalifax - `America/Havana`: AmericaHavana - `America/Hermosillo`: AmericaHermosillo - `America/Indiana/Indianapolis`: AmericaIndianaIndianapolis - `America/Indiana/Knox`: AmericaIndianaKnox - `America/Indiana/Marengo`: AmericaIndianaMarengo - `America/Indiana/Petersburg`: AmericaIndianaPetersburg - `America/Indiana/Tell_City`: AmericaIndianaTellCity - `America/Indiana/Vevay`: AmericaIndianaVevay - `America/Indiana/Vincennes`: AmericaIndianaVincennes - `America/Indiana/Winamac`: AmericaIndianaWinamac - `America/Inuvik`: AmericaInuvik - `America/Iqaluit`: AmericaIqaluit - `America/Jamaica`: AmericaJamaica - `America/Juneau`: AmericaJuneau - `America/Kentucky/Louisville`: AmericaKentuckyLouisville - `America/Kentucky/Monticello`: AmericaKentuckyMonticello - `America/Kralendijk`: AmericaKralendijk - `America/La_Paz`: AmericaLaPaz - `America/Lima`: AmericaLima - `America/Los_Angeles`: AmericaLosAngeles - `America/Lower_Princes`: AmericaLowerPrinces - `America/Maceio`: AmericaMaceio - `America/Managua`: AmericaManagua - `America/Manaus`: AmericaManaus - `America/Marigot`: AmericaMarigot - `America/Martinique`: AmericaMartinique - `America/Matamoros`: AmericaMatamoros - `America/Mazatlan`: AmericaMazatlan - `America/Menominee`: AmericaMenominee - `America/Merida`: AmericaMerida - `America/Mexico_City`: AmericaMexicoCity - `America/Miquelon`: AmericaMiquelon - `America/Moncton`: AmericaMoncton - `America/Monterrey`: AmericaMonterrey - `America/Montevideo`: AmericaMontevideo - `America/Montserrat`: AmericaMontserrat - `America/Nassau`: AmericaNassau - `America/New_York`: AmericaNewYork - `America/Nome`: AmericaNome - `America/Noronha`: AmericaNoronha - `America/North_Dakota/Beulah`: AmericaNorthDakotaBeulah - `America/North_Dakota/Center`: AmericaNorthDakotaCenter - `America/North_Dakota/New_Salem`: AmericaNorthDakotaNewSalem - `America/Ojinaga`: AmericaOjinaga - `America/Panama`: AmericaPanama - `America/Paramaribo`: AmericaParamaribo - `America/Phoenix`: AmericaPhoenix - `America/Port-au-Prince`: AmericaPortAuPrince - `America/Port_of_Spain`: AmericaPortOfSpain - `America/Porto_Velho`: AmericaPortoVelho - `America/Puerto_Rico`: AmericaPuertoRico - `America/Punta_Arenas`: AmericaPuntaArenas - `America/Rankin_Inlet`: AmericaRankinInlet - `America/Recife`: AmericaRecife - `America/Regina`: AmericaRegina - `America/Resolute`: AmericaResolute - `America/Rio_Branco`: AmericaRioBranco - `America/Santarem`: AmericaSantarem - `America/Santiago`: AmericaSantiago - `America/Santo_Domingo`: AmericaSantoDomingo - `America/Sao_Paulo`: AmericaSaoPaulo - `America/Scoresbysund`: AmericaScoresbysund - `America/Sitka`: AmericaSitka - `America/St_Barthelemy`: AmericaStBarthelemy - `America/St_Johns`: AmericaStJohns - `America/St_Kitts`: AmericaStKitts - `America/St_Lucia`: AmericaStLucia - `America/St_Thomas`: AmericaStThomas - `America/St_Vincent`: AmericaStVincent - `America/Swift_Current`: AmericaSwiftCurrent - `America/Tegucigalpa`: AmericaTegucigalpa - `America/Thule`: AmericaThule - `America/Tijuana`: AmericaTijuana - `America/Toronto`: AmericaToronto - `America/Tortola`: AmericaTortola - `America/Vancouver`: AmericaVancouver - `America/Whitehorse`: AmericaWhitehorse - `America/Winnipeg`: AmericaWinnipeg - `America/Yakutat`: AmericaYakutat - `Antarctica/Davis`: AntarcticaDavis - `Antarctica/DumontDUrville`: AntarcticaDumontDUrville - `Antarctica/Macquarie`: AntarcticaMacquarie - `Antarctica/Mawson`: AntarcticaMawson - `Antarctica/McMurdo`: AntarcticaMcMurdo - `Antarctica/Palmer`: AntarcticaPalmer - `Antarctica/Rothera`: AntarcticaRothera - `Antarctica/Syowa`: AntarcticaSyowa - `Arctic/Longyearbyen`: ArcticLongyearbyen - `Asia/Aden`: AsiaAden - `Asia/Almaty`: AsiaAlmaty - `Asia/Amman`: AsiaAmman - `Asia/Anadyr`: AsiaAnadyr - `Asia/Aqtau`: AsiaAqtau - `Asia/Aqtobe`: AsiaAqtobe - `Asia/Ashgabat`: AsiaAshgabat - `Asia/Atyrau`: AsiaAtyrau - `Asia/Baghdad`: AsiaBaghdad - `Asia/Bahrain`: AsiaBahrain - `Asia/Baku`: AsiaBaku - `Asia/Bangkok`: AsiaBangkok - `Asia/Barnaul`: AsiaBarnaul - `Asia/Beirut`: AsiaBeirut - `Asia/Bishkek`: AsiaBishkek - `Asia/Brunei`: AsiaBrunei - `Asia/Chita`: AsiaChita - `Asia/Colombo`: AsiaColombo - `Asia/Damascus`: AsiaDamascus - `Asia/Dhaka`: AsiaDhaka - `Asia/Dili`: AsiaDili - `Asia/Dubai`: AsiaDubai - `Asia/Dushanbe`: AsiaDushanbe - `Asia/Gaza`: AsiaGaza - `Asia/Hebron`: AsiaHebron - `Asia/Ho_Chi_Minh`: AsiaHoChiMinh - `Asia/Hong_Kong`: AsiaHongKong - `Asia/Hovd`: AsiaHovd - `Asia/Irkutsk`: AsiaIrkutsk - `Asia/Jakarta`: AsiaJakarta - `Asia/Jayapura`: AsiaJayapura - `Asia/Jerusalem`: AsiaJerusalem - `Asia/Kabul`: AsiaKabul - `Asia/Kamchatka`: AsiaKamchatka - `Asia/Karachi`: AsiaKarachi - `Asia/Kathmandu`: AsiaKathmandu - `Asia/Khandyga`: AsiaKhandyga - `Asia/Kolkata`: AsiaKolkata - `Asia/Krasnoyarsk`: AsiaKrasnoyarsk - `Asia/Kuala_Lumpur`: AsiaKualaLumpur - `Asia/Kuching`: AsiaKuching - `Asia/Kuwait`: AsiaKuwait - `Asia/Macau`: AsiaMacau - `Asia/Magadan`: AsiaMagadan - `Asia/Makassar`: AsiaMakassar - `Asia/Manila`: AsiaManila - `Asia/Muscat`: AsiaMuscat - `Asia/Nicosia`: AsiaNicosia - `Asia/Novokuznetsk`: AsiaNovokuznetsk - `Asia/Novosibirsk`: AsiaNovosibirsk - `Asia/Omsk`: AsiaOmsk - `Asia/Oral`: AsiaOral - `Asia/Phnom_Penh`: AsiaPhnomPenh - `Asia/Pontianak`: AsiaPontianak - `Asia/Pyongyang`: AsiaPyongyang - `Asia/Qatar`: AsiaQatar - `Asia/Qostanay`: AsiaQostanay - `Asia/Riyadh`: AsiaRiyadh - `Asia/Sakhalin`: AsiaSakhalin - `Asia/Samarkand`: AsiaSamarkand - `Asia/Seoul`: AsiaSeoul - `Asia/Shanghai`: AsiaShanghai - `Asia/Singapore`: AsiaSingapore - `Asia/Srednekolymsk`: AsiaSrednekolymsk - `Asia/Taipei`: AsiaTaipei - `Asia/Tashkent`: AsiaTashkent - `Asia/Tbilisi`: AsiaTbilisi - `Asia/Tehran`: AsiaTehran - `Asia/Thimphu`: AsiaThimphu - `Asia/Tokyo`: AsiaTokyo - `Asia/Tomsk`: AsiaTomsk - `Asia/Ulaanbaatar`: AsiaUlaanbaatar - `Asia/Urumqi`: AsiaUrumqi - `Asia/Ust-Nera`: AsiaUstNera - `Asia/Vientiane`: AsiaVientiane - `Asia/Vladivostok`: AsiaVladivostok - `Asia/Yakutsk`: AsiaYakutsk - `Asia/Yangon`: AsiaYangon - `Asia/Yekaterinburg`: AsiaYekaterinburg - `Asia/Yerevan`: AsiaYerevan - `Atlantic/Azores`: AtlanticAzores - `Atlantic/Bermuda`: AtlanticBermuda - `Atlantic/Canary`: AtlanticCanary - `Atlantic/Cape_Verde`: AtlanticCapeVerde - `Atlantic/Faroe`: AtlanticFaroe - `Atlantic/Madeira`: AtlanticMadeira - `Atlantic/Reykjavik`: AtlanticReykjavik - `Atlantic/South_Georgia`: AtlanticSouthGeorgia - `Atlantic/St_Helena`: AtlanticStHelena - `Atlantic/Stanley`: AtlanticStanley - `Australia/Adelaide`: AustraliaAdelaide - `Australia/Brisbane`: AustraliaBrisbane - `Australia/Broken_Hill`: AustraliaBrokenHill - `Australia/Darwin`: AustraliaDarwin - `Australia/Eucla`: AustraliaEucla - `Australia/Hobart`: AustraliaHobart - `Australia/Lindeman`: AustraliaLindeman - `Australia/Lord_Howe`: AustraliaLordHowe - `Australia/Melbourne`: AustraliaMelbourne - `Australia/Perth`: AustraliaPerth - `Australia/Sydney`: AustraliaSydney - `Europe/Amsterdam`: EuropeAmsterdam - `Europe/Andorra`: EuropeAndorra - `Europe/Astrakhan`: EuropeAstrakhan - `Europe/Athens`: EuropeAthens - `Europe/Belgrade`: EuropeBelgrade - `Europe/Berlin`: EuropeBerlin - `Europe/Bratislava`: EuropeBratislava - `Europe/Brussels`: EuropeBrussels - `Europe/Bucharest`: EuropeBucharest - `Europe/Budapest`: EuropeBudapest - `Europe/Busingen`: EuropeBusingen - `Europe/Chisinau`: EuropeChisinau - `Europe/Copenhagen`: EuropeCopenhagen - `Europe/Dublin`: EuropeDublin - `Europe/Gibraltar`: EuropeGibraltar - `Europe/Guernsey`: EuropeGuernsey - `Europe/Helsinki`: EuropeHelsinki - `Europe/Isle_of_Man`: EuropeIsleOfMan - `Europe/Istanbul`: EuropeIstanbul - `Europe/Jersey`: EuropeJersey - `Europe/Kaliningrad`: EuropeKaliningrad - `Europe/Kirov`: EuropeKirov - `Europe/Kyiv`: EuropeKyiv - `Europe/Lisbon`: EuropeLisbon - `Europe/Ljubljana`: EuropeLjubljana - `Europe/London`: EuropeLondon - `Europe/Luxembourg`: EuropeLuxembourg - `Europe/Madrid`: EuropeMadrid - `Europe/Malta`: EuropeMalta - `Europe/Mariehamn`: EuropeMariehamn - `Europe/Minsk`: EuropeMinsk - `Europe/Monaco`: EuropeMonaco - `Europe/Moscow`: EuropeMoscow - `Europe/Oslo`: EuropeOslo - `Europe/Paris`: EuropeParis - `Europe/Podgorica`: EuropePodgorica - `Europe/Prague`: EuropePrague - `Europe/Riga`: EuropeRiga - `Europe/Rome`: EuropeRome - `Europe/Samara`: EuropeSamara - `Europe/San_Marino`: EuropeSanMarino - `Europe/Sarajevo`: EuropeSarajevo - `Europe/Saratov`: EuropeSaratov - `Europe/Simferopol`: EuropeSimferopol - `Europe/Skopje`: EuropeSkopje - `Europe/Sofia`: EuropeSofia - `Europe/Stockholm`: EuropeStockholm - `Europe/Tallinn`: EuropeTallinn - `Europe/Tirane`: EuropeTirane - `Europe/Ulyanovsk`: EuropeUlyanovsk - `Europe/Vaduz`: EuropeVaduz - `Europe/Vatican`: EuropeVatican - `Europe/Vienna`: EuropeVienna - `Europe/Vilnius`: EuropeVilnius - `Europe/Volgograd`: EuropeVolgograd - `Europe/Warsaw`: EuropeWarsaw - `Europe/Zagreb`: EuropeZagreb - `Europe/Zurich`: EuropeZurich - `Indian/Antananarivo`: IndianAntananarivo - `Indian/Chagos`: IndianChagos - `Indian/Christmas`: IndianChristmas - `Indian/Cocos`: IndianCocos - `Indian/Comoro`: IndianComoro - `Indian/Kerguelen`: IndianKerguelen - `Indian/Mahe`: IndianMahe - `Indian/Maldives`: IndianMaldives - `Indian/Mauritius`: IndianMauritius - `Indian/Mayotte`: IndianMayotte - `Indian/Reunion`: IndianReunion - `Pacific/Apia`: PacificApia - `Pacific/Auckland`: PacificAuckland - `Pacific/Bougainville`: PacificBougainville - `Pacific/Chatham`: PacificChatham - `Pacific/Chuuk`: PacificChuuk - `Pacific/Easter`: PacificEaster - `Pacific/Efate`: PacificEfate - `Pacific/Fakaofo`: PacificFakaofo - `Pacific/Fiji`: PacificFiji - `Pacific/Funafuti`: PacificFunafuti - `Pacific/Galapagos`: PacificGalapagos - `Pacific/Gambier`: PacificGambier - `Pacific/Guadalcanal`: PacificGuadalcanal - `Pacific/Guam`: PacificGuam - `Pacific/Honolulu`: PacificHonolulu - `Pacific/Kiritimati`: PacificKiritimati - `Pacific/Kosrae`: PacificKosrae - `Pacific/Kwajalein`: PacificKwajalein - `Pacific/Majuro`: PacificMajuro - `Pacific/Marquesas`: PacificMarquesas - `Pacific/Midway`: PacificMidway - `Pacific/Nauru`: PacificNauru - `Pacific/Niue`: PacificNiue - `Pacific/Norfolk`: PacificNorfolk - `Pacific/Noumea`: PacificNoumea - `Pacific/Pago_Pago`: PacificPagoPago - `Pacific/Palau`: PacificPalau - `Pacific/Pitcairn`: PacificPitcairn - `Pacific/Pohnpei`: PacificPohnpei - `Pacific/Port_Moresby`: PacificPortMoresby - `Pacific/Rarotonga`: PacificRarotonga - `Pacific/Saipan`: PacificSaipan - `Pacific/Tahiti`: PacificTahiti - `Pacific/Tarawa`: PacificTarawa - `Pacific/Tongatapu`: PacificTongatapu - `Pacific/Wake`: PacificWake - `Pacific/Wallis`: PacificWallis - `UTC`: Utc
  - `wage_type` 1 | 2 — Possible values: - `1`: Salary - `2`: HourlyWage
  - `weekstart_monday` boolean — Start week on Monday?
  - `show_favorites` boolean
  - `mail_to_user` boolean — Sent mail to the new co-worker? (default: false)
  - `start_date` string, date, nullable
  - `budget_notifications` boolean
  - `edit_lock` string, date, nullable — The date after the co-worker is not allowed to edit his entries anymore. Can only be set by administrators or workers with elevated access `manage_users_access`.
  - `edit_lock_dyn` 1 | 2 | 3 | 5 | 8 | 15 | 31 | 46 | 91 — Possible values: - `1`: LockDays1 - `2`: LockDays2 - `3`: LockDays3 - `5`: LockDays5 - `8`: LockDays8 - `15`: LockDays15 - `31`: LockDays31 - `46`: LockDays46 - `91`: LockDays91
  - `edit_lock_sync` boolean — Can future changes to the company-wide edit lock overwrite the edit lock for this co-worker? Can only be set by administrators or workers with elevated access `manage_users_access`.
  - `work_time_edit_lock_days` 0 | 1 | 2 | 3 | 5 | 8 | 15 | 31 | 46 | 91 — Possible values: - `0`: LockDays0 - `1`: LockDays1 - `2`: LockDays2 - `3`: LockDays3 - `5`: LockDays5 - `8`: LockDays8 - `15`: LockDays15 - `31`: LockDays31 - `46`: LockDays46 - `91`: LockDays91
  - `default_holidays_count` boolean — Uses the company's default holiday count
  - `default_target_hours` boolean — Uses the company's default target hours
  - `work_time_regulations_id` integer, nullable
  - `default_work_time_regulation` boolean — Uses the company's default work time regulation
  - `exempt_from_flextime` boolean — Is exempt from flextime violation evaluation
  - `absence_managers_id` integer[]
  - `access_groups_ids` integer[]
  - `bill_service_id` string, nullable

## Response `200`

Successful operation

- object
  - `data` UserV3, required
    - `id` integer, required
    - `name` string, required
    - `weekstart_monday` boolean, required — If false, the week starts on Sunday
    - `weekend_friday` boolean, required — This property no longer has any effect
    - `active` boolean, required
    - `timeformat_12h` boolean, required
    - `language` 'en' | 'fr' | 'de', required
    - `timezone` string, required — e.g. `Europe/Berlin`
    - `teams_id` integer, nullable, required
    - `initials` string, required
    - `nonbusiness_groups_id` integer, nullable, required — deprecated; use v2/usersNonbusinessGroups instead
    - `nonbusinessgroups_id` integer — deprecated; use nonbusiness_groups_id instead
    - `number` string, nullable
    - `work_time_regulations_id` integer, nullable — `0` if the co-worker has no work time regulation\n`null` if the company default is applicable
    - `default_work_time_regulation` boolean — Uses the company's default work time regulation
    - `worktime_regulation_id` integer, nullable — deprecated; use work_time_regulations_id instead
    - `boss` integer, nullable
    - `absence_managers_id` integer[]
    - `access_groups_ids` integer[]
    - `email` string
    - `role` 'worker' | 'owner' — Possible values: - `worker`: Worker - `owner`: Administrator
    - `can_generally_see_absences` boolean — Only editable for co-workers with the role 'worker'
    - `can_generally_manage_absences` boolean — Only editable for co-workers with the role 'worker'
    - `can_add_customers` boolean — Only editable for co-workers with the role 'worker'
    - `default_holidays_count` boolean — Uses the company's default holiday count
    - `default_target_hours` boolean — Uses the company's default target hours
    - `future_coworker` boolean — The future co-worker cannot log in yet and the license is free until the start date.
    - `start_date` string, date, nullable
    - `exit_date` string, date, nullable — The co-worker is automatically archived when this date is reached. Use the `put` action to set or update this value.
    - `wage_type` 1 | 2 — Possible values: - `1`: Salary - `2`: HourlyWage
    - `edit_lock` string, date, nullable — Defined editing lock for the co-worker
    - `edit_lock_dyn` 1 | 2 | 3 | 5 | 8 | 15 | 31 | 46 | 91 — Possible values: - `1`: LockDays1 - `2`: LockDays2 - `3`: LockDays3 - `5`: LockDays5 - `8`: LockDays8 - `15`: LockDays15 - `31`: LockDays31 - `46`: LockDays46 - `91`: LockDays91
    - `edit_lock_sync` boolean, nullable
    - `work_time_edit_lock_days` 0 | 1 | 2 | 3 | 5 | 8 | 15 | 31 | 46 | 91 — Possible values: - `0`: LockDays0 - `1`: LockDays1 - `2`: LockDays2 - `3`: LockDays3 - `5`: LockDays5 - `8`: LockDays8 - `15`: LockDays15 - `31`: LockDays31 - `46`: LockDays46 - `91`: LockDays91
    - `budget_notifications` boolean
    - `creator` integer, nullable
    - `created_at` string, date-time
    - `bill_service_id` string, nullable — Only visible for administrators or workers with elevated access `manage_add_ons` and `manage_users_and_teams` and if a billing application with user support is linked up
    - `support_pin` string
    - `exempt_from_flextime` boolean — Is exempt from flextime violation evaluation

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Entity

---

[API](https://skmtc.dev/clockodo/apis/clockodo-api-documentation.md) · [All operations](https://skmtc.dev/clockodo/apis/clockodo-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clockodo/clockodo-api-documentation/revisions/38e281d50d6d/schema)
