Skip to main content
To homepage To homepage

Developer Platform, APIs, & Integrations

Connect with your fellow developers!

  • 3,628 Questions
  • 7,741 Replies

Knowledge Base (3)

  • Can I create a JWT credential via an API?

    Article by
    ByrneReese
    ByrneReese

  • How do I request a rate limit increase for my application?

    Question by
    A
    alexandra-gonzi

  • How do I add/invite a developer to my developer account?

    Article by
    ByrneReese
    ByrneReese
3623 Questions
S
Shashank217548030Participating Frequently
asked in Developer Platform, APIs, & Integrations
Does RingCentral support a Redtail CRM integration?

Ringcentral can integrate with Redtail crm? docs available?

11001
ByrneReese
Community Manager
B
BeckyNew Participant
posted in Developer Platform, APIs, & Integrations
RingCentralCallControl returning Uncaught TypeError: Object prototype may only be an Object or null: undefined

My implementation: import RingCentral from "@rc-ex/core";import { RingCentralCallControl } from "ringcentral-call-control"; const ringcentralSdk = new RingCentral({ server: "", clientId: "", clientSecret: "", }); useEffect(() => { if (!ringcentralSdk) { console.error("ringcentralSdk is undefined"); return; } if (!webPhone) { console.error("webPhone is undefined"); return; } if (ringcentralSdk && webPhone) { const rcCall = new RingCentralCallControl({ sdk: ringcentralSdk, }); rcCall.on("new", (newSession) => { console.log(newSession, "rc call session"); }); // const activeSessions = rcCall.sessions; // activeSessions.forEach((session) => { // session.on("accepted", () => { // console.log("Call accepted:", session); // }); // session.on("progress", () => { // console.log("Call in progress:", session); // }); // session.on("established", () => { // console.log("Call established:", session); // }); // session.on("ringing", () => { // toast.success("Call ringing..."); // }); // session.on("

131
Embbnux
Community Manager
U
Unique60737561006New Participant
asked in Developer Platform, APIs, & Integrations
I'm getting "None of this user's phone number(s) has the SMS capability!"

I’m getting “None of this user's phone number(s) has the SMS capability!” error message. I could not find anything in my account to enable it. Please advice.

151
PhongVu
Community Manager
A
ajfahimParticipating Frequently
asked in Developer Platform, APIs, & Integrations
Is it possible to read incoming sms and provide reply to that sms

Is it possible to read incoming sms and provide reply to that sms. I am using nodejs

242
A
J
Jared FowkesNew Participant
asked in Developer Platform, APIs, & Integrations
Random Errors Rejecting and Dropping Call Sessions

I’m building a service that receives call events via a RingCentral webhook subscription, checks all of the numbers against a fraud service we use, and rejects/drops the call if any participant is deemed suspicious. So far, everything works fine with my cell phone, which I’ve rigged to always return suspicious, but during live testing, I get several errors like AGW-404 and TAS-106. Attached is my log output, which includes details from the Webhook and responses when trying to drop/reject the call. According to the call logs, the call listed in the attached log was accepted and lasted almost a minute before terminating normally.

213
PhongVu
Community Manager
A
asadNew Participant
asked in Developer Platform, APIs, & Integrations
Implementing Server-to-Client Call Transfer

I'm implementing a RingCentral integration that requires starting calls from a server-side application and later transferring those active calls to a client-side web application. Specifically: I use the server-side softphone JS implementation (ringcentral-softphone-js) to initiate outbound calls When needed, I want to transfer the active call to a WebPhone instance running in a React client application My research indicates RingCentral has a built-in "Switch call to this device" feature, which appears to accomplish this type of transfer using SIP protocol mechanisms rather than the REST API. Technical Research So Far I've analyzed the SIP traffic during a "Switch call to this device" operation and found it sends a specialized SIP INVITE with a Replaces header: INVITE sip:+15551234567@sip.ringcentral.com SIP/2.0Via: SIP/2.0/WSS xxxx.invalid;branch=z9hG4bKxxxxxxxMax-Forwards: 70To: <sip:+15551234567@sip.ringcentral.com>From: <sip:15551234567*101@sip.ringcentral.com>;tag=xxxxxxxxCall-ID:

161
PhongVu
Community Manager
H
hoonkangNew Participant
asked in Developer Platform, APIs, & Integrations
Is there a way to programmatically access notes and transcripts from voice calls?

Hi, I am trying to see if I can get this: data programmatically through the API. I haven’t been able to see anything in the documentation and from what I’m aware this is a newer feature. Are there any plans to implement this? I understand there is a workaround by using Get on CallRecording and feeding the recording into the AI Insights/Audio endpoint, but getting this data directly and having it be the same as what is displayed to the user would be ideal.

161
PhongVu
Community Manager
D
DarrylBFCNew Participant
asked in Developer Platform, APIs, & Integrations
RingSense Transcripts (HOW!?!?)

I have tried to access the API to no avail and this is getting extremely frustrating now. We have RingSense licenses, user’s are set to record conversations and produce transcripts. I can successfully authenticate to the /insights API: https://platform.ringcentral.com/ai/ringsense/v1/public/accounts/~/domains/pbx/records/3129356…./insights ERROR: { "errorCode": "InsufficientPermissions", "message": "In order to call this API endpoint, application needs to have [RingSense] permission", "errors": [ { "errorCode": "CMN-401", "message": "In order to call this API endpoint, application needs to have [RingSense] permission", "permissionName": "RingSense" } ], "permissionName": "RingSense" } The Developer playground “Try It” … DOES NOT WORK. The API documentation is vague. We’ve tried using Postman to connect, producing the above error. We’ve tried using Zapier to get the “ProcessedRecording” event, which does not work. Searching this community produces results where people are saying it’s “N

315
D
C
CamilleNew Participant
asked in Developer Platform, APIs, & Integrations
Règles automatiques transfert appel

Est-il possible de couper les appels entrants automatiquement lorsque le statut est en "en réunion" ? Le lien avec le compte Google permet de faire apparaître un statut en réunion mais les appels apparaissent lorsque l’on est en réunion ou en rendez vous.

30
C
H
hasfougNew Participant
asked in Developer Platform, APIs, & Integrations
Create call handling rule without introductory greeting via API

I am working on call queue setup automation. Custom answering rule API seems to be the great fit for my needs, but the problem is I can not disable queue introduction speech programmatically. No matter what I send in greetings list of my rule, the Call Queue Greeting checkbox is always checked by default. It sucks that I would need to go and uncheck this one for every queue that I am creating while everything else can be automated. This is the request body that I send: {"enabled":true,"type":"Custom","name":"Restaurant Olive queue business hours answering rule","schedule":{"weeklyRanges":{"monday":[{"from":"12:00","to":"15:00"},{"from":"18:00","to":"21:00"}],"tuesday":[{"from":"12:00","to":"15:00"},{"from":"18:00","to":"21:00"}],"wednesday":[{"from":"12:00","to":"15:00"},{"from":"18:00","to":"21:00"}],"thursday":[{"from":"12:00","to":"15:00"},{"from":"18:00","to":"21:00"}],"friday":[{"from":"12:00","to":"15:00"},{"from":"18:00","to":"21:00"}],"saturday":[{"from":"12:00","to":"15:00"},{

304
H
A
ana-1New Participant
asked in Developer Platform, APIs, & Integrations
SMS outbound no longer works for Company Main Number

I have had an ongoing issue for 3 weeks now, where my Company Main Number can no longer send outbound SMS texts. My direct lines still work, but I need the Main Number to be active. The Main number can still receive texts from clients but we can not send out. I have had several calls with Support and every answer I get is that my case has been escalated and someone from Tier 3 is working on it. The most common answer given to me is that there is a bug in my account where my number gets blocked after a certain amount of texts sent out. I also received a message that my texts are violating phishing traffic content policies from RingCentral but our content has not changed from 2018 when we first started using the service. RingCentral are able to unblock the number, but it's inevitable that it gets blocked again after a day of use. Has anyone experienced the same issue and know how I can fix it? Or is there a phone number and extension to a department that I can speak to that they can help

143317
M
N
nblaneyNew Participant
asked in Developer Platform, APIs, & Integrations
RingCentral for Intune Android SSO Blank Page

I have configured an Intune MAM policy and included RingCentral for Intune. I have an app protection policy including RC and all MS apps and have the app added to Intune (RingCentral for Intune > Google Play Store, not Managed Play Store). I’ve configured send org data to other apps is policy managed apps only and telecommunication data out to any dialer app. This is working for me on iPhone, SSO (Azure) authenticates against the Microsoft Authenticator app as broker and the sign in is completed back to RC successfully. On Android however, SSO launches from RC app to Edge Browser (in the MAM policy and Edge is signed in/syncing), some URL’s load it seems as SSO is approved, but it is not sent back to RC app, the login just sits on Edge showing a blank screen with URL https://login.ringcentral.com/api/sso/login? Thanks,

161
N
A
aashirmNew Participant
asked in Developer Platform, APIs, & Integrations
Call not received with Primary number but with Organization number only.

So, I am trying to make a call using my own Primary Number and the post request gets me 200 code but the call is never received on the recipient number. But when I just change the number to organization number, the code from API is 200 and the call is received on the recipient number as well. I tried changing the caller ID to Primary as well but that doesn’t seem to be solving the issue either. The call status turns out to be: Call placed. Call status: InProgress but the call is never received. Any solutions?

112
A
N
Nate2390738036Inspiring
asked in Developer Platform, APIs, & Integrations
Phone Call Notes and API

Hello! Is there a plan to add the AI notes functionality to the API? For example, being able to enable Notes of a phone call via API, and also to be able to retrieve those notes? Looking through the API, the only “notes” calls I see are for Messages, but not for phone calls. Thanks!

211
PhongVu
Community Manager
H
hasfougNew Participant
asked in Developer Platform, APIs, & Integrations
RingCentral Embeddable incoming call unstable rc-active-call-notify event

I am working on a call center product which is based on RingCentral queues. I’ve created a queue and assigned it a direct phone number. Now, I am using embeddable widget and I am able to receive and accept calls, so this part is working fine. However, I need to do some calls to my server API based on caller and recipient (direct queue) phone numbers and this is where I have issues. I am using event listener which is looking for a message with following type: rc-active-call-notify Most of the time it works fine, but sometimes this event is just not being fired, even though I do receive a call and can accept it without any issue.Also, if I just wait on the line, I can actually see that call is being “reset” (I see in browser console Event: Rejected and then Event: Terminated entries, the widget blinks as if it was re-rendered, but the call will still keep on ringing) and after that I do see rc-active-call-notify event. Problem is I have to wait like 10-15 sec which is not realistic in re

434
H
M
merrileeNew Participant
asked in Developer Platform, APIs, & Integrations
Can I text a PDF?

I just spoke to the Ring Central helpline after attempting to text a PDF document. Helpline claims we should be able to text a PDF, however it's now allowing me to do so. I can text a PNG and a JPEG, but otherwise the options are "grayed out" on my laptop, or a pop up message says "this format is not supported." They mentioned issues like overage on our texting, or the PDF having an issue like a virus, both of which don't make sense. Please clarify if this is possible. Thank you!!

9699
J
M
MCPSNew Participant
asked in Developer Platform, APIs, & Integrations
Grant-Type issue on app with JWT Flow

App Client ID is WaOUXvk0oXtdlR79ZvmEZtI created a private app for us to use, and I selected JWT flow however when running js to get the access token I get Username/password authentication is deprecated. Please migrate to the JWT grant type. Which is starnge because I selected the JWT flow when creating it and I’m using the provided script. Could I please get this looked into or advice?

382
M
G
glenglishNew Participant
asked in Developer Platform, APIs, & Integrations
Calls started from API, Conferenced via RC Phone App

I am initiating two calls via the RingCentrall Call Out API. Once both calls are connected (one active, one on hold) the user will start the conference call from the RC Phone app. Should information about the conference call be available somewhere in the call records? Right now, I only see call logs for the two calls I made and no conference call.

60
G
M
MKenyon2New Participant
asked in Developer Platform, APIs, & Integrations
Upgrading NuGet from 5.18 to 6.3 AccountCallLogSyncResponse

We’ve been getting some errors reading call logs from the ring central API. One thing I wanted to try was updating to the most recent API. But when I upgrade the nuget package, I receive errors about AccountCallLogSyncResponse missing. I searched through documentation for release notes, but couldn’t find anything. Is there a document that helps?

301
T
Community Manager
R
rsandreaNew Participant
asked in Developer Platform, APIs, & Integrations
How can I know if a recording is available?

Hello all, I understand that there are no webhooks to know if a recording is available, I’ve done most of my integration, I’m getting the recordingId from the telephony event “disconnect”, now I need to get the recording, Tech Support said that the recording is not available real time that I will have to poll the content API, which should be this one: /restapi/v1.0/account/accountId/recording/recordingId/content, however in the docs it says that that API only returns 200 with the recording media as the body, so, my question is, how does the return code and body looks like when the recording is not available to download? should I check for a 404 status code and retry later? how does that work? Thanks, Raul

427
PhongVu
Community Manager
J
josh-villalobosParticipating Frequently
asked in Developer Platform, APIs, & Integrations
I wrote a script that uses SMS perfectly and auth token works fine on my personal number. However, I can't sms out of a group number that I am part of. What do I need to check?

Pretty much as the title says. If my personal number is 555-555-5555 in the script, the SMS goes through. I am part of a group that has the number of 999-999-9999. If I switch to that number, it breaks permissions in the script. Here’s the response paste after my access token. SMS Response: { "errorCode" : "FeatureNotAvailable", "message" : "Phone number doesn't belong to extension", "errors" : [ { "errorCode" : "MSG-304", "message" : "Phone number doesn't belong to extension" } ]}Error sending SMS: Phone number doesn't belong to extension

221
PhongVu
Community Manager
M
macrobberNew Participant
asked in Developer Platform, APIs, & Integrations
Failed to create subscription: WebHook responds with incorrect HTTP status. HTTP status is 404

I have an unbuntu server running apache with virtual directories. I’m getting the following error when I attempt to register a webhook: Failed to create subscription: WebHook responds with incorrect HTTP status. HTTP status is 404. The code that is rendering this error is: async function createSubscription() { try { let response = await platform.post('/restapi/v1.0/subscription', { eventFilters: [ "/restapi/v1.0/account/~/extension/~/telephony/sessions" ], deliveryMode: { transportType: "WebHook", address: process.env.WEBHOOK_URL } }); console.log("Subscription created:", response.data); } catch (error) { console.error("Failed to create subscription:", error.message); }}

161
PhongVu
Community Manager
C
CANODEVParticipating Frequently
asked in Developer Platform, APIs, & Integrations
What roles are necessary for an app to call from any *extension* to any domestic number?

Is it possible to call any domestic number from any extension within my organization using a server-side application? I need to place a call on the user's behalf, and I do not want them to authenticate, hence the need for a server-side solution var parameters = new MakeRingOutRequest { from = new MakeRingOutCallerInfoRequestFrom { phoneNumber = "15559000410" // Assume this is a queue number }, to = new MakeRingOutCallerInfoRequestTo { phoneNumber = "15559991234" }, playPrompt = false, }; // Call from any extension in my company, possible to call on behalf? var resp = await restClient.Restapi().Account().Extension(“XXXXXXXX”).RingOut().Post(parameters); Console.WriteLine("Call Placed. Full Response:\n" + JsonConvert.SerializeObject(resp, Formatting.Indented)) But I keep getting .. “In order to call this API endpoint for another extension, one of the following permissions [InternalCalls, DomesticCalls, InternationalCalls] have to be granted with extended scope to the authorized user”.

515
C
ByrneReese
Community Manager
ByrneReeseProduct Manager
posted in Developer Platform, APIs, & Integrations
Help resolving issues relating to the redirect URI in OAuth

OAuth's authorization code flow requires developers to register with RingCentral a redirect URL to which users authenticating will be sent upon successfully authenticating. Each app can register multiple redirect URIs (which is commonly just a URL in the classic https:// format) in order to accommodate different user flows. The specific URL an app want to redirect a user is sent by the app when the user is initially sent to RingCentral to login. This URL must match one of the redirect URIs on file for that application. If it doesn't then the following error will be returned by RingCentral: { "error" : "invalid_grant", "errors" : [ { "errorCode" : "OAU-109", "message" : "Redirect URIs do not match" } ], "error_description" : "Redirect URIs do not match" } This check is essential to maintaining the security of RingCentral and of your application, and prevents third-parties from hyjacking your app and redirecting authenticated users to untrusted sites. Another error may be returned in the

35063
M
A
asadNew Participant
asked in Developer Platform, APIs, & Integrations
Issue with createSIPRegistration API - Device Restriction & Transport Protocol Errors

I am experiencing issues with the createSIPRegistration API when attempting to register a SIP device using the following endpoint: createSIPRegistration API. Issue Details: Error when passing device.id in the request body: Request fails with the following error: { "errorCode": "SPR-123", "message": "device is not allowed for Web.", "errors": [ { "errorCode": "SPR-123", "message": "device is not allowed for Web.", "applicationType": "Web", "parameterName": "device" } ], "applicationType": "Web", "parameterName": "device"} Error when not passing device.id and setting sipInfo.transport as TCP or TLS: Response: 503 Service Unavailable. Error when setting sipInfo.transport as UDP: Request fails with the following error: { "errorCode": "SPR-112", "message": "Client edition is not compatible with current Brand", "errors": [ { "errorCode": "SPR-112", "message": "Client edition is not compatible with current Brand" } ]} Working case: When using WSS as sipInfo.transport, the registration succeed

575
T
Community Manager

Most helpful members this week

Popular tags

Having trouble finding an answer?

We can’t know everything, but we can help point you in the right direction with these resources:

Terms & ConditionsCookie settings

Cookie policy

We use cookies to enhance and personalize your experience. If you accept you agree to our full cookie policy. Learn more about our cookies.

 
Cookie settings
PRODUCTS
RingEX
Message
Video
Phone
OPEN ECOSYSTEM
Developer Platform
APIs
Integrated Apps
App Gallery
Developer support
Games and rewards

RESOURCES
Resource center
Blog
Product Releases
Accessibility
QUICK LINKS
App Download
RingCentral App login
Admin Portal Login
Contact Sales
© 1999-2024 RingCentral, Inc. All rights reserved. Privacy Notice