In this article
Note: Some images may refer to Microsoft® Entra ID as 'Active Directory'
Objective
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.
Questions
How does the integration match users?
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.
How can I tell if a user is synced?
Whether a user is synced is displayed on the Users tab of the integration. To review a user’s status:
From the navigation menu, click Settings
From Integrations & API, click Entra ID
Click Users
Navigate to or search for the user you want to review
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).
I’m getting this token error; what does it mean?
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.
What causes duplicate users and how can I get rid of them?
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.
Why aren’t staff archiving when I remove them in Coconut?
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.