Integrate with Microsoft Entra ID (Azure Active Directory)
Integrating TINYpulse Engage with your company's existing Microsoft Entra ID (Azure Active Directory) will simplify user management through automation. No longer will you have to manually add users one by one, or send an import file to the TINYpulse Customer Success Team. Complete the Active Directory integration once, and users will sync automatically into TINYpulse.
( ! )This integration is only for user management and is not for Single Sign-On. If you would like to set up a Single Sign-On integration with Microsoft Entra ID (Azure Active Directory), please reach out to our Support team so that they can help you build out this integration.
Prerequisites
To complete this integration, you'll need these three things:
- A Microsoft Entra ID instance at your company
- Global Admin rights to your Entra ID instance
- Super Admin rights in TINYpulse
( ! ) If you are missing any one of these three things, please contact your in-house technical team for assistance before proceeding.
Integrating TINYpulse with Entra ID
Whether you are new to TINYpulse or you have been pulsing for years, the Entra ID integration will significantly decrease your time spent housekeeping employees in TINYpulse.
1. Log in to TINYpulse and navigate to the Integrations page under the Settings tab.
2. Locate the Entra ID 'card' in the list and click to open it.
3. Click Connect.
4. Enter your Active Directory login credentials and Sign In.
5. You will be asked to grant permission to TINYpulse to the Entra ID instance. Read the message and "Accept" to return to TINYpulse.
6. Now that you are integrated, you still have to import the Entra ID groups to TINYpulse. Select the group(s) from the dropdown list that you would like to sync and click Add when you are done.
If you are new to TINYpulse and have not invited any users yet, but your account has launched, clicking Add will send invitation emails to new users immediately. Once they get the email, employees can set their TINYpulse password and will have full access to respond to their Engage survey, send Cheers, give anonymous suggestions, and more.
If your account has not launched yet, then your users will be added to your account, but they will not be sent an invitation to join TINYpulse until your account has launched.
If you have been pulsing for a while and are just looking to simplify user management going forward, existing TINYpulse users will be unaffected by the sync. They will not get any sort of notification from TINYpulse. However, if there are any TINYpulse users in your account that do not appear in Entra ID, they will be deactivated immediately. Entra ID serves as the one source of truth, so please make sure that all of your TINYpulse users belong to one of the Entra ID groups you have synced.
Changing Your Update Preferences
When you select Entra ID groups to sync to TINYpulse, they will import instantly, and groups will be auto-synced once per day on weekdays after that at Midnight UTC. (Not sure where you land by comparison? The World Clock can help!)
The default setting is to sync selected Entra ID groups automatically. You can opt for manual updates by going to the Apps section and switching automatic updates off. When you switch to manual update mode, an Update button will appear so you can manually sync users between Entra ID and TINYpulse on demand.
Turn off auto-updates for more control of your imports. However, we recommend keeping auto-updates on, especially if you have a dedicated Entra ID group for TINYpulse use. See below for more information about creating a new Entra ID group.
Sync Segments*
Segments have been replaced by Primary Attributes for better qualitative and quantitative reporting. If you are new to TINYpulse, we recommend leaving the "Segments Sync" feature off for your Entra ID integration.
Create a group specifically for TINYpulse in Entra ID
We recommend creating one group in Entra ID specifically for TINYpulse, especially if you have a large organization and not everyone needs access. Use this group to prevent syncing employees who actually do not need TINYpulse and will count against your per-seat subscription size. Instead of inviting and deactivating employees directly in TINYpulse, you can simply add or remove them from the AD group and they will be synced for you.
For detailed instructions on how to create a new Entra ID group for your TINYpulse application, please see the Entra ID documentation for Managing Groups.
Frequently Asked Questions
Will my existing users get overwritten if I import them from Entra ID?
If the employee's email address from Entra ID matches the one in TINYpulse then they will not be overwritten. They will still keep their Cheers, Pulse Streaks, and Attributes, the only difference is their name will update if there is a mismatch between Entra ID and TINYpulse. Entra ID is considered the source of truth so the sync will update the name in TINYpulse to match.
What happens if an existing TINYpulse user does not belong to any of the Entra ID groups I have synced to TINYpulse?
Once you have completed your configuration, any users who do not belong to one of the synced Entra ID groups will be deactivated in TINYpulse. To avoid any disruption to your users and admin team, make sure that all TINYpulse users belong to an Entra ID group that is being synced to TINYpulse.
Can I use Onboard for new hires with the Entra ID integration?
Not by default. You'll need to reach out to TINYpulse Support to have your integration updated to support Onboard new hire surveys. Please contact our Support team
How do I deactivate a user when using Entra ID integration?
You have to remove them from the Entra ID group itself. We recommend creating a specific Entra ID group for TINYpulse, and you can add or remove users as needed (see below). If you deactivate a user in TINYpulse without removing them from the Entra ID group, they will be reactivated during the next sync.
What happens if I deactivate a user in TINYpulse but they still belong to the Entra ID group?
They will get reactivated during the next sync. See above.
What happens if a deactivated TINYpulse user gets synced from Entra ID?
The deactivated TINYpulse user will reactivate if they belong to an imported Entra ID group. Remove the employee from the Entra ID group in order to keep them deactivated in TINYpulse.
What happens when a user gets removed from the Entra ID group?
They will be deactivated in TINYpulse and will not count against your per-seat subscription size.
Fields that we pull from Entra ID:
- Supported standard properties are documented here: User Resource Type - Microsoft Graph v1.0
However, we currently only pull id, displayName, givenName, jobTitle, mail, officeLocation, surname, userPrincipalName, department and employeeHireDate. - Regarding manager-related information, we are still pulling manager_email and manager_employee_id. But please note that these fields will not appear in the payload if the HRIS integration is configured on our end to not sync managers.
- For extension attributes, if you request it of us, we will sync all of them, which are documented here: Microsoft Extensibility Overview - Extension Attributes
- For custom fields, we will need you to provide us the list of fields you would like to sync to TINYpulse.
Comments
0 comments
Please sign in to leave a comment.