Last updated: 2026-03-27

Source: https://support.freshservice.com/support/solutions/articles/50000006143-freshservice-integration-with-zoom

Configure the Zoom integration to securely manage user data and automate administrative actions directly from your Freshservice service desk.

Setting up the Zoom integration

Follow these steps to configure the integration within your Zoom and Freshservice accounts.

1. Access the Zoom App Marketplace:

1. Log in to your Zoom Admin account.

2. In the navigation menu, go to Advanced > App Marketplace.

3. In the top right corner, select Develop > Build App.

2. Create a new app:

1. Select General App (this builds a web app to securely integrate with Zoom APIs and access authorized data using OAuth 2.0). 2. Select Create to proceed.

3. Configure app settings:

1. Ensure the Development button is selected (located in the middle of the page) to publish the app within the Zoom Marketplace and restrict external access. 2. Rename the app (displayed at the top left corner) to your preferred name. For example Heimdall Test. 3. Under Select How the App is Managed, choose Admin-managed (this allows account admins to manage the app and access user data based on selected scopes). 4. Click Save

4. Copy App credentials

1.Copy the Client ID and Client Secret (these will be required for further configuration).

5. Configure OAuth Settings:

1. Under OAuth Information, add the following URL in both the Redirect URL for OAuth and Allow Lists sections: https://{{domain}}.freshservice.com/api/_/credentials/oauth_callback

2. Note: Replace {{domain}} with your Freshservice account domain (for example, eucinternalauto1).

3. Select Continue.

6\. Set Access, Surface, and Embed Settings:

1. On the Access page, proceed without making any changes.

2. On the Surface page, proceed without making any changes.

3. On the Embed page, proceed without making any changes.

7\. Define Scopes:

1. On the Scope page, select Add Scopes and use the search bar to find the necessary permissions.

2. For example, to remove a member from a group, locate the Remove a Group’s Member action under Product Group and select the scope.

Important: Do not select Contact Group scopes. Ensure you only choose permissions related to the Product Group.

8\. Finalizing the Setup:

1. Once all 28 required scopes are added, the Zoom side of the configuration is complete.

2. Log in to your Freshservice account to update the Zoom OAuth credentials using the Client ID and Client Secret obtained in Step 5.

Scope description

The following table describes the scope.

ProductScopeActionDescriptionLicence Type
Groupgroup:write:group:adminCreate GroupCreate a groupA Pro or higher account
Groupgroup:update:group:adminUpdate GroupUpdate a groupPro, Business, or Education account
Groupgroup:read:group:adminGet Group DetailsView a groupPro, Business, or Education account
Groupgroup:delete:group:adminDelete GroupDelete a groupA Pro, Business, or Education account.
Groupgroup:write:member:adminAdd Group MemberAdd members to a groupA Pro, Business, or Education account.
Groupgroup:update:member:adminUpdate Group MemberUpdate a group's memberA Pro or higher account
Groupgroup:delete:member:adminDelete Group MemberRemove a group's memberA Pro, Business, or Education account
Rolerole:write:role:adminCreate RoleCreate a roleA Pro or higher plan
Rolerole:update:role:adminUpdate RoleUpdate a roleA Pro or higher plan
Rolerole:read:role:adminGet RoleView a roleA Pro or higher plan
Rolerole:delete:role:adminDelete RoleDelete a roleA Pro or higher plan
Rolerole:write:member:adminAssign Role to MemberAdd a member to a roleA Pro or higher plan
Rolerole:delete:member:adminUnassign a Member RoleRemove a role's memberA Pro or higher plan
Meetingmeeting:read:meeting:adminGet Meeting DetailsView a meetingHost user must have a Zoom Meetings Basic license or higher
Meetingmeeting:write:meeting:adminCreate MeetingCreate a meeting for a user
Meetingmeeting:delete:meeting:adminDelete MeetingDelete a meeting
Meetingmeeting:write:registrant:adminAdd Meeting RegistrantAdd a registrant to a meetingThe host must be a Licensed user type
Useruser:read:user:adminGet User Details with IDView a user
Useruser:read:list\_permissions:adminGet Granted Permissions for User with IDView a user's permissions
Useruser:write:user:admin1. Create User<br> <br>2. Create User Outside Managed Domain<br> <br>3. Create Standalone User<br> <br>4. Create SSO UserCreate a userA Pro or higher plan
Useruser:update:user:adminUpdate User with IDUpdate a user
Useruser:delete:user:adminDelete User with IDDelete a user
Useruser:update:email:adminUpdate User’s Email with IDUpdate a user's email
Useruser:update:password:adminUpdate User’s Password with IDUpdate a user's password
Useruser:update:status:admin1. Activate User with ID<br> <br>2. Deactivate User with IDUpdate a user's activation status
Useruser:delete:assistant:admin1. Delete User’s Assistants with ID<br> <br>2. Delete User’s Specified Assistant with IDRemove a user's assistant
Useruser:read:token:adminGet User’s Token with IDView a user's token
Useruser:delete:token:adminRevoke User’s SSO Token with IDRemove a user's token