John Wang avatar image
John Wang Posted ·

Using OAuth 2.0 Authorization Code Flow to Access RingCentral APIs

RingCentral APIs use the OAuth 2.0 protocol ( for authentication and authorization. Common OAuth 2.0 grant flows for web-based and installed applications are supported. For web-based applications, the OAuth 2.0 authorization code flow is supported and required, providing consistency, more trust and additional capabilities making it ideal for web use.

The authorization code flow provides the following benefits:
  1. a consistent and trusted UI
  2. integrated password reset
  3. integrated single sign-on (SSO) via SAML support
This is described in detailed in the RingCentral API Developer Guide:
Overall, just 2 HTTP requests are necessary, one to request an authorization code, and a second request to exchange the authorization code for an access token. A high-level description of the authorization code includes:
  1. configuring the redirect_uri in the Developer Portal:
  2. request #1: launching a browser window to make a call to an authorization URL
  3. having that window handle authentication and authorization
  4. having that window redirect back to the pre-configured redirect_uri
  5. extracting the authorization_code
  6. request #2: exchanging the authorization_code for an access_token
  7. closing the browser window
Additionally, the RingCentral JavaScript SDK has methods to handle the authorization code grant flows. Below are some official and community resources that can be used to understand and use RingCentral's OAuth authorization code flow:
If you have any questions regarding this, please reach out to us on online or open a support case:
1 |1000 characters needed characters left characters exceeded

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

No Comments

· Write a Comment

Write a Comment

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

Your Opinion Counts

Share your great idea, or help out by voting for other people's ideas.