NOTE: Some images may refer to Microsoft® Entra ID as 'Active Directory'

Sync users and user groups from Microsoft® Entra ID to Coconut for a more efficient staff creating/deleting/updating experience at your organization.

This article answers some of the most frequently asked questions related to the Microsoft® Entra ID integration.

For more info on the matching logic used for the integration, please refer to How the integration matches users in Connect Microsoft® Entra ID to Coconut.

Whether a user is synced is displayed on the Users tab of the integration. To review a user’s status:

Confirm whether a user is synced from Settings>Entra ID>Users

A grey dash indicates the user is not synced in Coconut through the Entra ID integration (the user was not added to Coconut through the Entra ID integration). A green checkmark indicates the user has been added to Coconut through the Entra ID integration (is synced).

This error indicates that the token used in the integration was revoked in Entra ID. To resolve this issue, a new token needs to be reissued and the integration needs to be reconnected.

This error indicates a new token is required for your Entra ID integration with Coconut

To do this, refer to Disconnect the integration in Connect Microsoft® Entra ID to Coconut and then follow the steps to connect the integration once more. Entra ID will reissue a new token as part of the setup process.

A duplicate user is the result of a sync not finding a matching user in Coconut for an incoming user from Entra ID. If an existing user’s First Name, Last Name, and Email fields in Coconut do not match the First Name, Last Name, and Email fields in Entra ID or an existing user’s First Name and Last Name fields in Coconut do not match the Display Name field in Entra ID, a new user is created, resulting in a duplicate.

To minimize the risk of duplicate users, ensure user details in Coconut fields match the details found in the corresponding Entra ID fields. For more information, please refer to Before you begin in Connect Microsoft® Entra ID to Coconut.

Please contact Coconut Support to have duplicate users removed.

When using the Entra ID <> Coconut integration, a staff member’s user profile must be removed from the Azure user group associated with the integration instead of archiving staff from within Coconut.

For more information on how to remove a user from a group, please refer to Microsoft’s documentation.