User Details

Represents a user's information. The user object is returned by the create or update user information endpoints.

Object fields

Name	Type	Description
id	integer	The staff's unique identifier in Marco.
name	string	The staff's full name.
platform_email	string	The staff's email, used to log into Marco.
home_country	string	The staff's home country, stored as an ISO Alpha-2 code. Example: JP
status	string	The staff's job status. Valid values: Inactive, Onboarding, Probation, Regular, Offboarded
job_title	string	The staff's job title. Example: HR Manager
job_scope	string	The job scope for the staff.
job_start_date	date	The staff's job start date, stored as YYYY-MM-DD.
probation_end_date	date	The staff's probation end date, stored as YYYY-MM-DD.
last_working_day	date	The staff's last working date, stored as YYYY-MM-DD.
offboarding_reason	string	The staff's offboarding reason. Valid values: Involuntary, Voluntary
gender	string	The staff's gender. Valid values: Female, Male
birthdate	date	The staff's date of birth, stored as YYYY-MM-DD. Example: 1980-01-31
location	string	The staff's work location.
work_email	string	The staff's work email.
home_country_engagement_type	string	The staff's engagement type. Valid values: Internal, EOR, IC
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 phone 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
reporting_officer	string	The staff's reporting manager.
host_country	string	The staff's host country, stored as an ISO Alpha-2 code. Applies to Expat staff only.
host_country_engagement_type	string	The staff's engagement type in the host country. Applies to Expat staff only. Valid values: Internal, EOR. IC

Example

---

{
  "name": "Li Lei",
  "role": "Staff",
  "system_email": "[email protected]",
  "id": 1348,
  "home_country": "CN",
  "status": "Regular",
  "offboarding_reason": "",
  "birthdate": "",
  "gender": "Male",
  "highest_education": "University",
  "nationality": "CN",
  "personal_email": "[email protected]",
  "phone": "8617623453456",
  "emergency_name": "Han Meimei",
  "emergency_email": "[email protected]",
  "emergency_phone": "[phone]",
  "emergency_relationship": "Mother",
  "reporting_officer": "Tuan Tuan",
  "job_title": "Product Manager",
  "location": "Beijing",
  "home_country_engagement_type": "Internal",
  "work_email": "[email protected]",
  "job_start_date": "2020-01-31",
  "probation_end_date": "2020-07-01",
  "last_working_day": null,
  "host_country": "",
  "host_country_engagement_type": "",
  "job_scope": "",
}