Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.

Connect RingCentral

A workspace administrator needs a RingCentral developer account and one RingCentral OAuth app for the workspace. Each person then connects their own RingCentral account through the usual RingCentral sign-in and consent screen. They do not need to create a developer app.

Create the developer app

  1. Sign in to the RingCentral Developer Console with the organization that will own the app.
  2. Create a REST API app. Under Authentication, choose 3-legged OAuth flow authorization code and Server-side web app. Enable refresh tokens.
  3. Add all three redirect URLs exactly as shown:
    https://app.stackyapper.dev/api/oauth/ringcentral/phone/callback
https://app.stackyapper.dev/api/oauth/ringcentral/chat/callback
https://app.stackyapper.dev/api/oauth/ringcentral/admin/callback
  4. Allow the permissions your team will connect:
    • Phone: ReadAccounts, ReadContacts, ReadCallLog, ReadMessages, ReadPresence, SMS. If your developer app offers AI and you need Phone AI access, also allow it.
    • Chat: ReadAccounts, TeamMessaging.
    • Admin: ReadAccounts, TeamMessaging, ReadCallLog, ReadMessages, ReadPresence. RingCentral may require its own review before it enables a restricted permission for your app.
  5. Copy the app's client ID and client secret. In Stackyapper, open Apps → RingCentral → Connect account, enter both values under RingCentral developer app, and choose Save developer app. Select Request Phone AI access only if your RingCentral app has the AI permission.
Stackyapper checks whether RingCentral's authorization server accepts the three redirect URLs before saving. This check does not verify the client secret; RingCentral checks it when a person completes sign-in. If RingCentral rejects a callback, compare its URL in the developer app character by character with the URL above. The developer app must be available in the RingCentral environment used by your account.

Connect an account

Choose Add RingCentral account, sign in with your normal RingCentral account, and review the Phone consent. After Phone connects, choose Connect Chat or Connect Admin for the same account. You can add and name more than one RingCentral account. When more than one can be used for a request, select the intended connection.
RingCentral Admin may display permissions beyond the five scopes requested above, including call control, role management, messaging changes, and webhooks. Review the actual consent screen before approving it. RingCentral may also require account setup, such as a registered emergency calling address, before finishing authorization.

Change the app or reconnect

An administrator can replace the client ID and secret in the same RingCentral panel. Every connected person must then reconnect Phone, followed by any Chat and Admin connections they use. Existing grants from the previous app no longer count as connected.
RingCentral's hosted MCP servers are currently a connection pilot in Stackyapper. Their tools are under review and cannot be assigned or run yet. Connecting an account does not grant tool access.