Read Employee

Retrieve information about an employee based on their ID or email address.

Input

Field Definition Type Required

Employee

ID or Email

Unique identifier of the user. You can find the identifier using the URL for the employee within your Personio instance.

For example, if the URL is https://example.personio.de/staff/details/1234567, the employee identifier is 1234567.

 Text TRUE

Output

Field Definition Type

Result

ID

Unique identifier for the employee

 Text

First Name

Employee's first name

 Text

Last Name

Employee's family name

 Text

Email

Email address for the employee. This is predefined as the unique identifier used to assign employee data during import activity.

 Text

Gender

Employee's gender

 Text

Status

Employee status: Onboarding, Active, Inactive, Leave

 Text

Position

Position currently held within the company

 Text

Supervisor

Employee's supervisor

  • ID (Text) - Supervisor's unique identifier

  • First Name (Text) - Supervisor's first name

  • Last Name (Text) - Supervisor's family name

  • Email (Text) - Supervisor's email

 Object

Employment Type

Indicates whether an employee is employed internally or externally

 Text

Weekly Hours

An employee's contractually agreed weekly working hours. This value is linked to the employee salary.

 Text

Hire Date

Date from which a work contract is effective

 Date & Time

Contract End Date

Date on which a fixed-term work contract expires

 Date & Time

Termination Date

Date on which the employment terminates. After this date, the employee status is automatically set to Inactive

 Date & Time

Termination Type

Termination type

 Text

Termination Reason

Reason for termination

 Text

Probation Period End Date

End date of the probation period

 Date & Time

Created At

Creation date for the employee record

 Date & Time

Last Modified

Date when the employee record was last updated

 Date & Time

Subcompany

Subcompany that an employee works for if subcompanies have been set up

  • ID (Text) - Subcompany's unique identifier

  • Name (Text) - Subcompany name

 Object

Office

Office where an employee works

  • ID (Text) - Office unique identifier

  • Name (Text) - Office name

 Object

Department

Department where an employee works

  • ID (Text) - Department's unique identifier

  • Name (Text) - Department name

 Object

Cost Center

The relevant cost center. You can select several cost centers and assign different charge percentages to each.

  • ID (Text) - Cost center unique identifier

  • Name (Text) - Cost center name

  • Percentage (Number) - Percentage of allocated cost

 List of Objects

Public Holidays

Employee's public holidays

  • ID (Text) - Public holiday unique identifier

  • Name (Text) - Public holiday name

  • Country (Text) - Public holiday country

  • State (Text) - Public holiday state

 Object

Absence Entitlements

Employee's absence entitlements

  • ID (Text) - Absence entitlement unique identifier

  • Name (Text) - Absence entitlement name

  • Category (Text) - Absence entitlement category

  • Entitlement (Text) - Absence entitlement type

 List of Objects

Work Schedule

Employee's work schedule

  • ID (Text) - Work schedule unique identifier

  • Name (Text) - Work schedule name

  • Valid From (Text) - Work schedule start

  • Monday (Text) - Scheduled hours

  • Tuesday (Text) - Scheduled hours

  • Wednesday (Text) - Scheduled hours

  • Thursday (Text) - Scheduled hours

  • Friday (Text) - Scheduled hours

  • Saturday (Text) - Scheduled hours

  • Sunday (Text) - Scheduled hours

 Object

Fixed Salary

Employee's fixed salary

  • Value (Number) - Employee's salary

  • Currency (Text) - Currency type

 Object

Salary Interval

Interval between salary payments

 Text

Hourly Salary

Employee's hourly salary

  • Value (Number) - Employee's salary

  • Currency (Text) - Currency type

 Object

Vacation Day Balance

Number of vacation days available

 Number

Last Day of Work

Final day of employment

 Date & Time

Profile Picture

URL for employee's profile picture

 Text

Team

Employee's team

  • ID (Text) - Team's unique identifier

  • Name (Text) - Team name

 Object

Custom Fields

User-defined employee fields. Dynamically generated per connection.

Various