API Reference
Staff
The user object
represents a staff's information the user object is returned by the create or update user information endpoints object parameters name string string the staff's full name role string string the staff's role in marco valid values staff, manager, manager & staff, intern system email string string the staff's email, used to log into marco id integer integer the staff's unique identifier in marco example 99 country string string the staff's current country, stored as an iso alpha 2 code example jp status string string the staff's job status valid values inactive, onboarding, probation, regular, offboarded offboarding reason string string the staff's offboarding reason valid values involuntary, voluntary birthdate string string the staff's date of birth, stored as yyyy mm dd example 1980 01 31 gender string string the staff's gender valid values female, male highest education string string the staff's highest education nationality string string the staff's nationality, stored as the country's iso alpha 2 code personal email string string the staff's personal email phone string string the staff's phone number includes the country code emergency name string string the name of the staff's emergency contact emergency email string string the email belonging to the staff's emergency contact emergency phone string string the phone number belonging to the staff's emergency contact includes the country code emergency relationship string string the staff's relationship to the emergency contact example husband passport number string string the staff's passport number passport issue date string string the staff's passport issue date, stored as yyyy mm dd passport issuing country string string the staff's passport issuing country, stored as an iso alpha 2 code passport expiry date string string the staff's passport expiry date, stored as yyyy mm dd reporting officer string string the staff's reporting manager job title string string the staff's job title example hr manager location string string the staff's work location staff type string string the staff's service type valid values system, payroll, hro, eor work email string string the staff's work email ec entity string string the business entity that holds the employment relationship with the staff ec type string string the staff's employment contract type valid values fixed term, indefinite ec vendor string string the vendor that employs the staff applies to eor staff only job start date string string the staff's job start date, stored as yyyy mm dd probation end date string string the staff's probation end date, stored as yyyy mm dd ec start date string string the start date for the staff's employment contract, stored as yyyy mm dd this may differ from the job start date if multiple contracts have been signed in succession ec end date string string the end date for the staff's employment contract, stored as yyyy mm dd last working day string string the staff's last working day, stored as yyyy mm dd host country string string the staff's host country, stored as an iso alpha 2 code applies to expat staff only host staff type string string the staff's service type in the host country applies to expat staff only valid values system, payroll, hro, eor host ec entity string string the business entity that holds the employment relationship with the staff in the host country applies to expat staff only host ec vendor string string the vendor that employs the staff in the host country applies to expat eor staff only host ec type string string the staff's employment contract type in the host country applies to expat staff only valid values fixed term, indefinite host ec start date string string the start date for the staff's employment contract in the host country, stored as yyyy mm dd applies to expat staff only host ec end date string string the end date for the staff's employment contract in the host country, stored as yyyy mm dd applies to expat staff only job scope string string the job scope for the staff customer system id string string the staff's unique identifier in your company's system example the user object { "name" "li lei", "role" "staff", "system email" "lilei\@mail com", "id" 1348, "country" "cn", "status" "regular", "offboarding reason" "", "birthdate" "", "gender" "male", "highest education" "university", "nationality" "cn", "personal email" "ll\@mail com", "phone" "8617623453456", "emergency name" "han meimei", "emergency email" "hmm\@mail com", "emergency phone" "8618876546789", "emergency relationship" "mother", "passport number" "eg8213789", "passpost issue date" "", "passport issuing country" "", "passport expiry date" "", "reporting officer" "tuan tuan", "job title" "product manager", "location" "beijing", "staff type" "payroll", "work email" "lilei\@mail com", "ec entity" "", "ec type" "fixed term", "ec vendor" "", "job start date" "2020 01 31", "probation end date" "2020 07 01", "ec start date" "2020 01 31", "ec end date" "2025 07 01", "last working day" null, "host country" "", "host staff type" "", "host ec entity" "", "host ec vendor" "", "host ec type" "", "host ec start date" "", "host ec end date" "", "job scope" "", "customer system id" "50", },