---
title: "RingCentral"
slug: "ringcentral"
updated: 2026-02-10T20:11:32Z
published: 2026-02-10T20:11:32Z
canonical: "help.claritysecurity.com/ringcentral"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.claritysecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# RingCentral

This guide will show you how to set up the integration between RingCentral and Clarity Security.

**Estimated time to complete:** 10 minutes.

If you run into any problems, please contact your support team or [support@claritysecurity.io](mailto:support@claritysecurity.io).

> [!WARNING]
> RingCentral API
> 
> RingCentral restricts endpoints to specific Usage Plan Groups for their API:
> 
> - **Light Usage Plan Group** limited to Read Only
> - **Medium Usage Plan Group** limited to Provisioning Users and Entitlements
> - **Heavy Usage Plan Group** required for deprovisioning Users.
> 
> You can check out the details from RingCentral here: [https://developers.ringcentral.com/guide/basics/rate-limits#how-are-user-level-limits-calculated](https://developers.ringcentral.com/guide/basics/rate-limits#how-are-user-level-limits-calculated)

---

## **Configuring in your Downstream Application**

### **Step 1: Register Application**

Login to the [RingCentral Developers portal](https://developers.ringcentral.com), and Register a new App.

![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1770654896022.png?sv=2026-02-06&spr=https&st=2026-10-31T06%3A56%3A05Z&se=2026-10-31T07%3A56%3A05Z&sr=c&sp=r&sig=OHQksRKTHviHKeIW8DNADzWazcv3dpkdshG%2Bm4afZMY%3D)

### **Step 2: Select App Type**

Select the option shown for **REST API App**

![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1770654991691.png?sv=2026-02-06&spr=https&st=2026-10-31T06%3A56%3A05Z&se=2026-10-31T07%3A56%3A05Z&sr=c&sp=r&sig=OHQksRKTHviHKeIW8DNADzWazcv3dpkdshG%2Bm4afZMY%3D)

### **Step 3: Configure Auth Settings**

Fill out Auth section:

- Select **3-legged OAuth flow authorization code**
  - Select **Server-side web app (most common)**
- Copy the **OAuth Redirect URI** (From [Clarity Steps below, Step 4](/home/docs/ringcentral#step-4-connect-app))
  - The URL will look similar to this: **https://****YOUR_TENANT****.claritysecurity.io/application/oauthProcessCode/****ring-central**
  - **Red** values above may very per customer.
- Select **Yes** for **Issue refresh tokens?**

![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1770655468521.png?sv=2026-02-06&spr=https&st=2026-10-31T06%3A56%3A05Z&se=2026-10-31T07%3A56%3A05Z&sr=c&sp=r&sig=OHQksRKTHviHKeIW8DNADzWazcv3dpkdshG%2Bm4afZMY%3D)

### **Step 4: Configure Security Settings**

Select the following **Application Scopes**:

- **Edit Accounts**
- **Read Accounts**
- **Role Management**

If your scope requite approval, you may need to provide a detailed explanation for your Application Owners.

You should also select **private** for “**Who will be authorized to access your app?**”.

Finally, hit **Create** to complete the App Registration process.

![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1770655855885.png?sv=2026-02-06&spr=https&st=2026-10-31T06%3A56%3A05Z&se=2026-10-31T07%3A56%3A05Z&sr=c&sp=r&sig=OHQksRKTHviHKeIW8DNADzWazcv3dpkdshG%2Bm4afZMY%3D)

### **Step 5: Copy Client ID and Client Secret**

Copy the **Client ID** and **Client Secret** values provided to secure location. You will need these values briefly in the following steps inside the Clarity platform.

![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-1770656119640.png?sv=2026-02-06&spr=https&st=2026-10-31T06%3A56%3A05Z&se=2026-10-31T07%3A56%3A05Z&sr=c&sp=r&sig=OHQksRKTHviHKeIW8DNADzWazcv3dpkdshG%2Bm4afZMY%3D)

## **Configuring the** **Integration** **within Clarity**

### **Step 1: Login to your Clarity Security tenant**

> https://your-tenant.claritysecurity.io/

### **Step 2: Click on Applications, then Marketplace**

![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-40MYXW2Q.png?sv=2026-02-06&spr=https&st=2026-10-31T06%3A56%3A05Z&se=2026-10-31T07%3A56%3A05Z&sr=c&sp=r&sig=OHQksRKTHviHKeIW8DNADzWazcv3dpkdshG%2Bm4afZMY%3D)

### **Step 3: Find RingCentral**

Scroll to or search for RingCentral in the list of applications from the marketplace, then click **Connect**.

![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-IRN7C664.png?sv=2026-02-06&spr=https&st=2026-10-31T06%3A56%3A05Z&se=2026-10-31T07%3A56%3A05Z&sr=c&sp=r&sig=OHQksRKTHviHKeIW8DNADzWazcv3dpkdshG%2Bm4afZMY%3D)

### **Step 4: Connect App**

Complete the **Connect App** form. Details for fields common to all applications can be found at the following article: [Common App Configuration Steps](/docs/common-app-configuration-steps)

- **OAuth Client ID**:
- **OAuth Client Secret**:
- Select which RingCentral API Usage Plan Group you have.
  - **Light (Read Only)**
  - **Medium (Provisioning User and/or Entitlements)**
  - **Heavy (Deprovisioning)**
- Grab the **OAuth Redirect URL** for use in the RingCentral Application Configuration in the Developer portal settings ([RingCentral Step 3 above](/home/docs/ringcentral#step-3-configure-auth-settings))
  - Note: the demo shown below will automatically show the correct value

![](https://cdn.document360.io/2d020999-1823-4d4d-b6d2-4b52fb4a9617/Images/Documentation/image-APHR4XTI.png?sv=2026-02-06&spr=https&st=2026-10-31T06%3A56%3A05Z&se=2026-10-31T07%3A56%3A05Z&sr=c&sp=r&sig=OHQksRKTHviHKeIW8DNADzWazcv3dpkdshG%2Bm4afZMY%3D)

### **Step 5: App Settings**

Complete the **App Settings** form. Details for each field can be found at the following article: [Common App Configuration Steps](/docs/common-app-configuration-steps)

### **Step 6: User Settings**

Complete the **User Settings** form. Details for each field can be found at the following article: [Common App Configuration Steps](/docs/common-app-configuration-steps)

### **Step 7: Validate Your Selections and Save**

Validate the selections from Configure App Step 3, and hit the **Save** button.

**Save**

Clicking the **Save** button will trigger the first full sync for your application (even if you selected Manual syncing). This includes Service Users, Entitlements, Service User Entitlements, Service User Attributes.

## **Need Help?**

If you have any problems, contact your customer success team. You can also get in touch with our general support [via email](mailto:support@claritysecurity.io), open a [support ticket](https://support.claritysecurity.com/home). Our general support team is available Monday - Friday from 8:00 AM - 6:30 PM CST.

A Downstream Application is any application that supplies Clarity with service users, entitlements, and attributes.

An Integration is any application, service, or data source used in Clarity for pulling in information about your users and their access.

A Service User is a user, or service account, discovered by Clarity in a downstream application.

An Entitlement is an assignable permission found in a downstream application. Common examples include licenses, groups, and policies.

Service User Entitlements are the pairings of users and active entitlement access in downstream applications.

An attribute is a piece of information used to describe a service user, entitlement, or identity. Common examples include First Name, Last Name, Job Title, Department, etc.