The Employees API is used to manage employee and user master data. Note: After migrating to IAM, any endpoints that alter data will be able to update all fields except ones controlled by IAM. IAM controlled fields can be updated using the IAM administration pages at https://accounts.plex.com.

Employee

Method
Description

GET

List Employees

https://connect.plex.com/mdm/v1/employees

List Employees by query parameters.

POST

Create Employee

https://connect.plex.com/mdm/v1/employees

Create a new Employee and associated User Account (if User ID provided does not already correspond to existing User). Note: Additional configuration required via User Manager to fully enable User login.

POST

Activate Employee

https://connect.plex.com/mdm/v1/employees/{id}/activate

Activate an Employee and the associated User Account. Note: Additional configuration is required via the User Manager to fully enable User login.

POST

Transfer Employee

https://connect.plex.com/mdm/v1/employees/{id}/transfer

Transfer an Employee to a different Tenant within the same Enterprise. Note: The Employee setup data must be available in the target Tenant in order for the Employee to transfer successfully.

POST

Deactivate Employee

https://connect.plex.com/mdm/v1/employees/{id}/deactivate

Deactivate an Employee and the associated User Account.

GET

Get Employee

https://connect.plex.com/mdm/v1/employees/{id}

Retrieve an Employee by Resource ID.

PUT

Update Employee

https://connect.plex.com/mdm/v1/employees/{id}

Update an Employee.

POST

Sync Employees

https://connect.plex.com/mdm/v1/employees/sync

Sync a set of Employees from another system. This operation creates Employees that do not exist in Plex and updates existing Employees.