> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-docs-confluence-api-token-update.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Ringcentral - OAuth Authentication

> Follow these steps to connect Ringcentral via the StackOne Hub successfully.

<Warning>
  Ensure that you have registered an account on [RingCentral Developers](https://developers.ringcentral.com/my-account.html) with Developer Admin privileges.
</Warning>

If you've been directed to StackOne to integrate with Ringcentral, the following steps will help you understand the process and any necessary actions to configure successful integration.

## Log in to RingCentral Developers

<Steps>
  <Step title="Register for RingCentral Developers">
    If you do not have a RingCentral Developers account, you can register for one here: [https://developers.ringcentral.com/sign-up](https://developers.ringcentral.com/sign-up)

    Your account should have the Role "Developer Admin".
  </Step>

  <Step title="Log in to RingCentral Developers">
    Log in to your [RingCentral Developers account](https://developers.ringcentral.com/my-account.html)
  </Step>
</Steps>

## Create a New Ringcentral Application

This connection will authenticate on behalf of a registered Application in RingCentral Developers.

<Steps>
  <Step title="View Apps">
    In Ringcentral Developers, click the Console button, then Apps on the left.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="View Apps" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/9bhFjdxQvzus54Ck/images/ringcentral/image1.png?fit=max&auto=format&n=9bhFjdxQvzus54Ck&q=85&s=b99e274a45cf61b71b0b41c436246255" width="1447" height="386" data-path="images/ringcentral/image1.png" />
    </Frame>
  </Step>

  <Step title="Register new App">
    Click the Register App button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Register App Button" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/9bhFjdxQvzus54Ck/images/ringcentral/image2.png?fit=max&auto=format&n=9bhFjdxQvzus54Ck&q=85&s=b2c3fb92d126b50bf6dee6c7750bd547" width="1430" height="357" data-path="images/ringcentral/image2.png" />
    </Frame>
  </Step>

  <Step title="Select App Type">
    Under App Type, select "REST API App (most common)" and click the Next button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Select App Type" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/9bhFjdxQvzus54Ck/images/ringcentral/image3.png?fit=max&auto=format&n=9bhFjdxQvzus54Ck&q=85&s=32f22bae79efd61bc86510b2d7803ccd" width="1195" height="598" data-path="images/ringcentral/image3.png" />
    </Frame>
  </Step>

  <Step title="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

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Enter App Properties" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/9bhFjdxQvzus54Ck/images/ringcentral/image4.png?fit=max&auto=format&n=9bhFjdxQvzus54Ck&q=85&s=4ea9a9c2309748104aeeee2432f404af" width="1212" height="892" data-path="images/ringcentral/image4.png" />
    </Frame>
  </Step>

  <Step title="Enter Auth Details">
    Scroll down to the Auth section, and enter the following details:

    * 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_iam/callback`
    * Issue refresh tokens? Yes

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Enter Auth Details" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/9bhFjdxQvzus54Ck/images/ringcentral/image5.png?fit=max&auto=format&n=9bhFjdxQvzus54Ck&q=85&s=ae4af8ce08dca7567c7059cb62377b2c" width="997" height="875" data-path="images/ringcentral/image5.png" />
    </Frame>
  </Step>

  <Step title="Enter Security Details">
    Under Security, select the following:

    * Application Scopes: Read Accounts
    * Who will be authorized to access your app? : This app is *private* and will only be callable using credentials from the same RingCentral account.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Enter Security Details" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/9bhFjdxQvzus54Ck/images/ringcentral/image6.png?fit=max&auto=format&n=9bhFjdxQvzus54Ck&q=85&s=5f191d5e7394390490fb04d719cbc966" width="1002" height="630" data-path="images/ringcentral/image6.png" />
    </Frame>

    Click the Create button to proceed. Upon seeing a success message, press the OK button.
  </Step>

  <Step title="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 safely to use in the following steps.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Copy API Credentials" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/9bhFjdxQvzus54Ck/images/ringcentral/image7.png?fit=max&auto=format&n=9bhFjdxQvzus54Ck&q=85&s=48081d2ac6c6f362252d01a6e9ff1a89" width="1003" height="239" data-path="images/ringcentral/image7.png" />
    </Frame>
  </Step>
</Steps>

## Connecting with StackOne

<Steps>
  <Step title="Enter Credentials">
    Upon reaching the Link Account page, enter the credentials from the previous steps:

    * Client ID
    * Client Secret

    Proceed by clicking the Connect button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Link Account" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/9bhFjdxQvzus54Ck/images/ringcentral/image8.png?fit=max&auto=format&n=9bhFjdxQvzus54Ck&q=85&s=85d1f14d66259f7f0ec162d54b73e3e5" width="483" height="575" data-path="images/ringcentral/image8.png" />
    </Frame>
  </Step>
</Steps>

<br />

Congratulations, you're all set! If you face any issues with the steps mentioned above,
please contact us by emailing [integrations@stackone.com](mailto:integrations@stackone.com). We're always here to assist you!

## Available data

This integration has the following [IAM Resources](https://docs.stackone.com/reference/iam_list_users) available from the provider:

<ul>
  <li>Users</li>
  <li>Roles</li>
  <li>Policies</li>
</ul>