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
The staff's full name.
role string
The staff's role in Marco.
Valid values: Staff, Manager, Manager & Staff, Intern
system_email string
The staff's email, used to log into Marco.
id integer
The staff's unique identifier in Marco.
Example: 99
country string
The staff's current country, stored as an ISO Alpha-2 code.
Example: JP
status string
The staff's job status.
Valid values: Inactive, Onboarding, Probation, Regular, Offboarded
offboarding_reason string
The staff's offboarding reason.
Valid values: Involuntary, Voluntary
birthdate string
The staff's date of birth, stored as YYYY-MM-DD.
Example: 1980-01-31
gender string
The staff's gender.
Valid values: Female, Male
highest_education string
The staff's highest education.
nationality string
The staff's nationality, stored as the country's ISO Alpha-2 code.
personal_email string
The staff's personal email.
phone string
The staff's phone number. Includes the country code.
emergency_name string
The name of the staff's emergency contact.
emergency_email string
The email belonging to the staff's emergency contact.
emergency_phone string
The phone number belonging to the staff's emergency contact. Includes the country code.
emergency_relationship string
The staff's relationship to the emergency contact.
Example: Husband
passport_number string
The staff's passport number.
passport_issue_date string
The staff's passport issue date, stored as YYYY-MM-DD.
passport_issuing_country string
The staff's passport issuing country, stored as an ISO Alpha-2 code.
passport_expiry_date string
The staff's passport expiry date, stored as YYYY-MM-DD.
reporting_officer string
The staff's reporting manager.
job_title string
The staff's job title.
Example: HR Manager
location string
The staff's work location.
staff_type string
The staff's service type.
Valid values: System, Payroll, HRO, EOR
work_email string
The staff's work email.
ec_entity string
The business entity that holds the employment relationship with the staff.
ec_type string
The staff's employment contract type.
Valid values: Fixed-term, Indefinite
ec_vendor string
The vendor that employs the staff. Applies to EOR staff only.
job_start_date string
The staff's job start date, stored as YYYY-MM-DD.
probation_end_date string
The staff's probation end date, stored as YYYY-MM-DD.
ec_start_date 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
The end date for the staff's employment contract, stored as YYYY-MM-DD.
last_working_day string
The staff's last working day, stored as YYYY-MM-DD.
host_country string
The staff's host country, stored as an ISO Alpha-2 code. Applies to Expat staff only.
host_staff_type 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
The business entity that holds the employment relationship with the staff in the host country. Applies to Expat staff only.
host_ec_vendor string
The vendor that employs the staff in the host country. Applies to Expat EOR staff only.
host_ec_type 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
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
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
The job scope for the staff.
customer_system_id string
The staff's unique identifier in your company's system.
Example