By clicking on "Install", you acknowledge and agree that your access and use of this application will be governed by the developer's terms of service and privacy policy. Freshworks may share your contact and usage information with the developer.
Install
OverviewRatings and ReviewInstallation InstructionsPrivacy & Security
This app enables Freshservice to import all your GSuite users to Freshservice account as requesters. The app also ensures that any changes made to the users in GSuite are reflected in Freshservice immediately.
Prerequisites:
1. The app should be configured by using your Google Workspace Account
Administrator
2. The “Trusted: can access all Google services” option needs to be enabled in
the Google Workplace admin settings. Follow the steps mentioned in the
solution article : https://help.dragapp.com/en/article/how-do-i-fix-the-this-
app-is-blocked-error-message-1xxo9nb/
Features:
1. Import all users from GSuite when the app is installed.
2. Real-time updates and deletes from GSuite.
3. Map custom (Single line text field) and default attributes in GSuite to appropriate Freshservice requester fields.
4. First name, Last name, Primary email address, and Address are mapped to Freshservice requesters by default during the sync.
5. Import filters - the ability to import users based on Address, Organization Name, Department, or Job title.
Caveats:
1. Default API Rate Limit & Sync Time
This app operates with a default API rate limit of 50 requests per minute (RPM). During the initial installation, if all mapping fields are configured, the app makes approximately 6 API calls per user. As a result, only 8 users can be synced every 5 minutes.
For example, if your G Suite account has 4,000 users, the complete sync process could take up to ~42 hours under the default rate limits.
2. Bulk Import Limitation & Best Practices
In scenarios involving bulk user imports, where webhook events are triggered instantaneously, the default 50 RPM limit can lead to sync failures. Additionally, the app can only process up to 200 external events per minute.
Given the 6 API calls required per user, only 8 users can be successfully synced in such cases.
To ensure smooth operation, we strongly recommend:
- Increasing the RPM limit before performing bulk imports
- Batching the user import in G Suite, limiting each batch to no more than 200 users
3. If you change the primary email for any user in GSuite, the app creates a new requester in Freshservice. The primary email is the unique identifier.
4.If any of the requester fields in Freshservice have been marked mandatory, be sure to map them during the installation.
5. The "Filter Users" option is intended solely for use during the initial installation of the app. It is not applicable for manual updates or real-time user synchronization.
6. The filter Users works only on the first time installation where the app would sync all the users available in the Gsuite. This won't work for Single user updates or updates done manually
7. In Filter User, if you are trying to filter using Organisation Unit Path, kindly configure in the following format :
If the user is in Freshworks Inc > India, then the value should be /India, where Freshworks Inc is the root organisation.
If the user is in Freshworks Inc > India > Chennai, then the value should be /India/Chennai.
1. Authorize the app by choosing and signing into your GSuite account.
2. You will be asked permission to access Users and User Schemas. Click "allow".
3. You'll then be redirected to the App setup page.
4. Enter your Freshservice Account URL and the API key associated with that account (preferably the API key of an administrator).
5. Click verify to verify the API key.
6. Two other sections are displayed at the bottom of the verification form (you may have to scroll down).
7. Map Custom Attributes (Optional) - You may choose to map the custom attributes in GSuite to Freshservice.
8. Filters (Optional) - You may choose to add filters to the import. Currently Address, Organization Name, Department and Job Title are the only valid filters. Choose a type of filter and type the value to search for on the right-hand side input.
9. Review all your information and click Install.
10. It may take a few seconds for the app to register itself with GSuite. Once the app is installed, it will start importing all your users.
11. Depending on the number of users the app may take several minutes to import all users (app imports users in batches(25 per batch) if you do not see all the users right after you install the app, make sure to check after some time).
Backed by a Platform-as-a-Service including a data store and serverless runtimes, and our rich Crayons component library, our SDK allows you to develop and deploy apps in a flash.