The Employees API is used to manage employee and user master data. Note: Any endpoints that alter data cannot be used if your PCN has been fully migrated to IAM. The Get and List endpoints are still accessible.

Employee

Method
Description

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.

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

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

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.

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

Deactivate Employee

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

Deactivate an Employee and the associated User Account.