Skip to main content

Manager Not Mapping from Okta to Workvivo

Bryan Byrne
  • Updated

Quick Overview

Ensure users are successfully provisioned with the correct manager in Workvivo by confirming that the required custom SCIM attribute for manager mapping is properly configured in Okta.

Error Message

If a user encounters issues with manager mapping, there may not always be a visible error message in Workvivo. Instead, the issue typically presents as:

  • Manager field is blank in Workvivo
  • Incorrect manager is assigned

This behaviour is usually driven by provisioning data from Okta rather than an issue within Workvivo itself.

Where the Issue Occurs

This issue occurs during the SCIM provisioning flow from Okta to Workvivo, before the data is fully processed by Workvivo.

If the manager attribute is not correctly configured or passed from Okta, Workvivo cannot assign the manager to the user.

Common Cause

In most cases, the affected user is impacted due to one of the following:

  • The required Workvivo custom attribute for manager mapping is not configured correctly in Okta
  • The manager value is not being passed in email format
  • The manager attribute is not populated for the user in Okta
  • The user provisioning update has failed or has not been retried after a change

How to Resolve the Issue

The customer’s Okta Administrator should complete the following steps:

1. Confirm Custom Attribute Configuration

Ensure the following custom attribute exists in Okta:

  • Display name: WVManager
  • Variable name: WVManager
  • External name: manager.value
  • External namespace: urn:ietf:params:scim:schemas:extension:enterprise:2.0:User
  • Description: WV Manager Attribute

This attribute must map to the manager’s email address.

If the manager value is not already in email format, an expression may be required, such as:

  • user.manager.email
  • getManagerUser("active_directory").email

2. Retry Provisioning

  • Select the affected users in Okta
  • Click Retry to trigger provisioning again

3. Reassign the User

  • Remove the affected user from the Workvivo Okta application
  • Reassign the user to the application

This will trigger a fresh provisioning event.

4. Confirm Sync Completion

Ensure that provisioning has successfully completed and that no errors are present in the Okta provisioning logs.

Additional Information

  • This issue originates from the Okta provisioning configuration, not Workvivo
  • Workvivo relies on SCIM data received from Okta to populate manager fields
  • Workvivo cannot override or manually persist manager values if SCIM provisioning is enabled
  • Any manual updates in Workvivo may be overwritten on the next sync
  • Changes may take a short time to reflect after provisioning runs

Still Having Issues?

If the configuration above has been confirmed as correct and the issue persists, please contact Workvivo Support for further assistance.

When reaching out, please include:

  • Example affected users
  • Okta provisioning logs (if available)
  • Confirmation of attribute mapping configuration

You can contact support at: support@workvivo.com

Related articles