RingCentral

Business communications platform

Go to site
Explore
/
Apps
/
RingCentral

RingCentral API Integrations

Build and run workflows using the RingCentral API. Use 1000s of open source triggers and actions across 700+ apps. Or write custom code to integrate any app or API in seconds.

import { axios } from "@pipedream/platform"
export default defineComponent({
  props: {
    ringcentral: {
      type: "app",
      app: "ringcentral",
    }
  },
  async run({steps, $}) {
    return await axios($, {
      url: `${this.ringcentral.$auth.instancetype}.ringcentral.com/restapi/v1.0/account/~`,
      headers: {
        Authorization: `Bearer ${this.ringcentral.$auth.oauth_access_token}`,
      },
    })
  },
})

Authentication

RingCentral uses OAuth authentication. When you connect your RingCentral account, Pipedream will open a popup window where you can sign into RingCentral and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any RingCentral API.

Pipedream requests the following authorization scopes when you connect your account:

OAuth Request Configurations:
  1. authorization
    GET{{custom_fields.instancetype}}.ringcentral.com/restapi/oauth/authorize?client_id={{oauth.client_id}}&redirect_uri={{oauth.redirect_uri}}&state={{oauth.state}}&response_type=code&scope={{oauth.space_separated_scopes}}
  2. accessToken
    POST{{custom_fields.instancetype}}.ringcentral.com/restapi/oauth/tokencontent-type: application/x-www-form-urlencodedaccept: application/json
    client_id={{oauth.client_id}}&client_secret={{oauth.client_secret}}&redirect_uri={{oauth.redirect_uri}}&grant_type=authorization_code&code={{oauth.code}}&Content Type=application/x-www-form-urlencoded
  3. refreshToken
    POST{{custom_fields.instancetype}}.ringcentral.com/restapi/oauth/tokencontent-type: application/x-www-form-urlencodedaccept: application/json
    client_id={{oauth.client_id}}&client_secret={{oauth.client_secret}}&grant_type=refresh_token&refresh_token={{oauth.refresh_token}}&Content Type=application/x-www-form-urlencoded