Skip to main content
Ensure that you have registered an account on RingCentral Developers with Developer Admin privileges.

​
Log in to RingCentral Developers

This connection authenticates on behalf of a registered application in RingCentral Developers.

1

Register for RingCentral Developers

If you do not have a RingCentral Developers account, you can register for one at https://developers.ringcentral.com/sign-up

  • Your account should have the Role Developer Admin
2

Log in to RingCentral Developers

​
Create a New RingCentral Application

Register a new application that StackOne will authenticate through.

1

View Apps

In RingCentral Developers, click the Console button, then Apps on the left.

2

Register new App

Click the Register App button.

3

Select App Type

Under App Type, select REST API App (most common) and click the Next button.

4

Enter App Properties

Under App Properties (internal-use only), enter the following details:

  • App Name: Enter a name for your new App
  • App description: Enter a description for your new App
  • Primary Contact: Enter the email address of the main support contact for this App
  • Do you intend to promote this app in the RingCentral App Gallery?: No
5

Enter Auth Details

Scroll down to the Auth section, and enter the following details:

  • Select 3-legged OAuth flow authorization code
  • From what type of app will you be calling the API?: Server-side web app (most common)
  • OAuth Redirect URI: https://api.stackone.com/connect/oauth2/ringcentral/callback
  • Issue refresh tokens?: Yes
6

Enter Security Details

Enables actions: Add BYOD Devices, Add Chat To Favorites, Add Opt-In/Out Numbers, Archive Team, Calls Aggregation Data, Calls Timeline Data, Cancel RingOut Call, Create Data Export Task, Create Extension, Create Fax Message, Create Message Store Report, Create Multiple User Extensions, Create Task, Create Team, Delete Conversation, Delete Message, Delete User Call Records, Delete User Extensions, Delete User Profile Image, Drop Call Session, Enable Automatic Location Updates For Users, Get Agent’s Call Queue Presence, Get Call Queue Presence, Get Call Session Status, Get Company Directory Entries, Get Contacts Upload Task, Get Data Export Task, Get Emergency Map Configuration Task, Get Event, Get Extension, Get Extension Update Task Status, Get Message Store Configuration, Get Message Store Report Task, Get Message(s), Get RingOut Call Status, Get Unified Presence, Get User Presence Status, Get User Profile Image, Get User Template, Get Video Meeting, List A2P SMS Statuses, List Call Queues, List Chat Tasks, List Company Active Calls, List Company User Roles, List Data Export Tasks, List Extension Devices, List Extensions, List Favorite Chats, List Favorite Contacts, List Messages, List Opted Out Numbers, List Teams, List User Active Calls, List User Administered Sites, List User Assigned Roles, List User Call Records, List User Events, List User Templates, List Video Meetings, Make CallOut, Make RingOut Call, Patch Message(s), Search Company Directory Entries, Send A2P SMS, Send MMS, Send SMS, Send/Resend Activation Email, Send/Resend Welcome Email, Start Conference Call Session, Unarchive Team, Update Agent’s Call Queue Presence, Update Call Queue Presence, Update Favorite Contact List, Update Message Store Configuration, Update Message(s), Update Multiple Extensions, Update Unified Presence, Update User Administered Sites, Update User Assigned Roles, Update User Call Queues, Update User Presence Status, Update User Profile Image, Upload Multiple User Contacts, Upload User Profile Image

Under Security, select the application permissions your integration needs, then choose who can access the app.

  • Application Scopes: select the permissions matching the actions you will use (e.g. ReadAccounts, ReadMessages, SMS, ReadCallLog, Contacts, TeamMessaging, RingOut, Faxes)
  • Who will be authorized to access your app?: This app is private and will only be callable using credentials from the same RingCentral account
  • Click the Create button to proceed. Upon seeing a success message, press the OK button.
  • Note: the StackOne connection test uses a permission-free RingCentral dictionary endpoint, so the connection will verify even with minimal permissions — but every action you intend to use still needs its application permission selected here, and permissions cannot be changed via the OAuth scope parameter later
7

Copy API Credentials

Your new App Client ID and Client Secret will now be available to copy.

  • Under Production Credentials, copy both your Client ID and Client Secret and store them securely for use later
  • Note: application permissions are fixed at app registration — the OAuth scope parameter is ignored by RingCentral

​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for RingCentral:
1

Navigate to Connector Profiles

Login to StackOne and navigate to Connector Profiles
2

Create New Connector Profile

  • Click + Connector Profile
  • Search for and select RingCentral
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • Scopes (Optional)
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile
Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for RingCentral.