APIs and Developer Console

When attempting to make a call queue, and including the cost center of the queue, i get an error with Error codeCMN-109 {    "extensionNumber": "{{extension}}",    "type": "Department",    "status": "Enabled",    "contact": {        "firstName": "{{queuename}}",        "email": "{{email}}"    },    "costCenter": {        "id": "{{costCenter}}"    },    "site": {        "id": "{{siteId}}"    },    "siteAccess": "Limited",    "regionalSettings": {        "homeCountry": {            "id": "{{homeCountryId}}"        },        "timezone": {            "id": "{{timezoneId}}"        },        "language": {            "id": "{{languageId}}"        },        "greetingLanguage": {            "id": "{{languageId}}"        },        "formattingLocale": {            "id": "{{languageId}}"        }    }} 

I have this message from the website developer. I am getting an error when trying to sync the call recordings with our systemI looked for Auth & permissions and could not find it Please let me know where it is: This is the message from the web person.----403 InsufficientPermissions"In order to call this API endpoint, application needs to have [ReadCallLog] permission"This isn't a code bug — your RingCentral app (the one tied to RINGCENTRAL_CLIENT_ID / RINGCENTRAL_JWT) is missing the ReadCallLog permission. RingCentral will keep returning 403 until that scope is added.Fix (takes ~2 minutes in RingCentral, not in code)Go to the RingCentral Developer Console → your app → Auth & Permissions (or App Settings → OAuth Settings). Under App Permissions, add: ReadCallLog (required — this is the one it's yelling about) ReadCallRecording (required so it can pull the audio file too

My company is trying to find a RingCentral third‑party application that can geo‑route inbound calls by ZIP code. I’ve been trying for a months to get this answered through RC Sales, and last week I was finally pointed to the Developers site.For context: I run nationwide marketing campaigns that rely on shared-use call flows. TV or radio spots promote a single phone number. When a viewer or listener calls, they’re prompted to enter their 5‑digit ZIP code, and the call is then transferred to a participating business in that specific area. Think of models like 1‑800‑Flowers, 888‑92‑NoPain (chiropractors). This ZIP‑based routing is essential to how our campaigns operate. I need to know whether RingCentral can support this—either natively or through a compatible third‑party solution—before I proceed with onboarding.Thank you in advance for helping me get a definitive answer.

Hi All,For some reason, my soft phone isn’t ringing when using the RingOut Endpoint.What am I missing?  With this url:https://platform.ringcentral.com/restapi/v1.0/account/~/extension/{{extensionId}}/ring-outAnd these headers: --request POST--header "Authorization: Bearer {{accessToken}}"--header "Content-Type: application/json"--data {{payload}} And this payload (properly quoted, of course):{  "from": { "phoneNumber": "{{fromNumber}}" },  "to":   { "phoneNumber": "{{toNumber}}" },  "playPrompt": true} I get this (encouraging) response: {  "uri" : "https://platform.ringcentral.com/restapi/v1.0/account/**********/extension/**********/ring-out/s-a...",  "id" : "s-a...",  "status" : {    "callStatus" : "InProgress",    "callerStatus" : "InProgress",    "calleeStatus" : "InProgress"  }} 

I'm integrating RingCentral with Pipedream using the "New Inbound Message (Instant)" trigger. When Pipedream calls the extension list endpoint to populate the dropdown, it crashes with:Cannot read properties of undefined (reading 'firstName')The result is the extension dropdown won't load, so I can't select my extension and deploy the trigger.My setup:Ext 101 — Halah Ladson, 704-941-4557 (the SMS line I want to listen on) Ext 102 — "Forward to English" (a call forwarding rule, no person attached)I believe Ext 102 is returning a contact object with no firstName field, which causes the crash when the integration iterates over the list.Questions:Is there a way to add a contact name to a forwarding extension so the API returns a valid object? If not, can I get Ext 101's internal API extension ID so I can enter it manually and bypass the dropdown? Is there a filter I can add to the extension list call to return only user-type extensions (exclude forwarding rules)?Endpoint I'm hitting: GET h

We are using the List Company Call Records API to retrieve call logs and store the logs in our own database. But we are not able to determine whether a call has fully ended or not, so we can store only those logs which has full call legs.Is there a specific field in the call log response that reliably indicates that a call has been ended completely or is there any recommended approach to find this out?

Hello there,All REST API endpoints for Ring CX Voice seem to be marked down as deprecated, however I would like to use them to retrieve calls to import into my CRM system.https://developers.ringcentral.com/engage/voice/api-reference/analyticsI see no data about replacement updated endpoints.Where are these?Thanks,Robin

## SetupWe use `ringcentral-softphone` to answer inbound calls that are routed through a single RingCentral **call queue** to one of several **agent softphones**.- **4 softphones** sit behind one queue, each a distinct RC user/extension with its own SIP credentials.## What we're trying to doFor every call we need to capture two kinds of data and store them under **one phone call record**, then display them together for a single call in our own UI:1. **Internal logs** (from the Node softphone process): a small set of details we write to our database when the call starts, against a unique identifier.2. **Telephony lifecycle**: the full call history — transfer → answered/rejected → transferred again → ended — which we obtain from an **account-level `telephony/sessions` webhook subscription** (or any better approach you'd recommend).**The core question: how can we tie these two records together with the same identifier?**## The problemFrom the SIP connection in `ringcentral-softphone(-ts)`

The problem: the `interaction-metadata` response does not include several interaction-level columns that appear in the in-app "Interaction Details" historical analytics report. Specifically missing:- Product Type / Product / Product ID (the queue/product the interaction belonged to)- Term Party and Term Reason- Agent Full Name (we only get the agent ID)- Abandon Type- Original UII- Callback RequestedThese fields do exist in the Agent Segment Metadata and Global Call Type Detail reports, but those appear to be deprecated.Question: Which current, supported endpoint returns these interaction-level fields — especially the Product/queue association and Term Reason? Is the `reportsStreaming` endpoint the intended path, or is a scheduled report export currently the only way to get the complete column set? We'd prefer to build against a supported endpoint rather than a deprecated one.Thanks!

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…./insightsERROR: {    "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 commu

We are currently evaluating how to leverage the ConnectWise PSA with RingCentral for Voice. We want to be able to click-to-call out of ConnectWise and integrate our RingCentral DID’s, possibly automate some of the call-logging as well. Is this possible to do with ConnectWise open API? ConnectWise pointed me in the direction of RingCentral integrations directly.

I already tried submitting a ticket for this, but got told to contact dev support. I'm not a dev, just an admin. So I'm going to try here before jumping into that mess. For some reason there is little online regarding my issue.I have recently migrated to the new RC SSO webapp that included SCIM integration for auto provisioning. So far it is working well, but it is having some strange issues with cell phone numbers and countries. I have not been able to nail down exactly what is going wrong, and I'm starting to wonder if the default mappings logic is not sufficient. I figured I would loop you guys in since I'm having trouble finding much documentation online so far.To be clear, our integration is fully configured and is running in update/create mode. We are syncing 42 users currently without issue. The rest(mostly outside the USA) are failing due to country field issues:SystemForCrossDomainIdentityManagementServiceIncompatibleStatusCode: BadRequest Message: Processing o

I have an application where I’d like to register a webhook for every logged in user (by extensionId). The most sensible way to do this is to have a subscription for each extensionId. However, I’m worried by this piece of documentation “Subscriptions are currently limited to 30 subscriptions per user/extension (for particular application).”Does this mean I can have up to 30 subscriptions per extensionId, and thus my current use case is no problem? Or is it 30 subscriptions per “user” aka per JWT? I notice that the ListSubscription documentation explicitly states “maxItems:30”, which would suggest the limit is not per extension.If I have 85 call center representatives who are signed in, how do I make sure I receive webhook call backs for all of them? Thanks for your help! 

Hello,I’ve been using the Multi-Site IVR Settings API to fetch our sites' IVR settings, and it has been working great.However, the API documentation states:Internal identifier of a site. Please note that siteId cannot take the main-site value.Is there any way to retrieve this information through another API call?Our Main Site IVR settings are used as the defaults for many of our IVR menus, but there currently doesn't seem to be a way for us to retrieve the default values for No Input, #, or * from the Main Site.Thank you. The data exists under Company > Sites > Main Site > Company Call Handling > Default IVR settings page 

We have an application in the Developer Portal which was originally created by one of our users.How does ownership of Developer Portal applications works?Specifically:Is the application owned by the RingCentral organisation or by the user who created it? If the creator’s RingCentral account is deleted in the future, will the application continue to function and remain accessible to other developers within the organisation?Main concern is if in 18 months or so the user who created the app leaves, we delete their account not realising we’re also deleting access to the app they made.  Thanks.  

I am trying to mass download all call recordings for my company. I am using this endpoint:https://developer.niceincontact.com/API/MediaPlaybackAPI#/RecordingMediaPlayback/getACDContactRecordingDataIf I provide an acd-call-id/master contact id I get from the admin portal I am able to download the recording. I need to do this for all our contacts. Is there an endpoint to list all contacts with the acd-call-id/master contact id, or a way to export a list from the admin panel? How do I get all contact ids?Thanks!

Hello,I am able to find the all of the DeviceID's assigned to an extension by calling this endpoint:https://platform.devtest.ringcentral.com/restapi/v1.0/account/accountId/extension/extensionId/deviceI can then use these DeviceID's to place a call using my chosen device by calling this endpoint and supplying the DeviceID:https://platform.devtest.ringcentral.com/restapi/v1.0/account/accountId/telephony/call-outMy question:How do I find the DeviceID of the RingCentral App?https://www.ringcentral.co.uk/desktop-app.htmlThe /extension/~/extensionId/device EndPoint only returns the ID's for Softphones and HardphonesThank you

I'm building an application where an operator may need to place a 911 call on behalf of someone at a location that:Is different from where the operator is physically located Changes dynamically at runtime (i.e. it is not known in advance)I understand that E911 is designed to address dispatchable location requirements for VoIP calls, but I'm struggling to find a clear, reliable API approach for this scenario. My key concern is timing: even if I update the registered E911 location via API immediately before the call is placed, I cannot guarantee that the updated location will be propagated to the PSAP before the call is answered. Can you please point me to the best practice and API set to use in this scenario ? thank you in advance. 

Hi everyone,I have a website integrated with RingCentral and would like to implement an AI note-taker feature within the pop up in our website.My goal is to:- Add a toggle button (Start/Stop AI Notetaker) during a call we opened that pop up-I am storing the call detail along with I need to store the notes as wellIs this feasible? if so kindly guide me to implement the featuretell me how to implement in step by step Thank you

Hi RingCentral community,I’m integrating the RingCentral embeddable/web phone widget into our website and using widget postMessage events to save call history.Issue:For an inbound call, if the call popup is open and the user answers from the mobile, I usually receive rc-active-call-notify with:data.call.telephonyStatus === "OnHold" But if the same inbound call is answered from the RingCentral mobile app, the browser widget sometimes receives rc-call-end-notify while:data.call.telephonyStatus is blank/missing or not reliable, and my stored value from rc-active-call-notify is also empty. Because of this, our service can incorrectly classify the call as missed even though it was answered on mobile.Questions:Is rc-active-call-notify.data.call.telephonyStatus expected to be reliable for calls answered on another device, such as RingCentral mobile? Which widget event should be used to know the final disposition of an inbound call? Does rc-call-end-notify.data.call include a stable ID, like t

Current approach:We were relying on rc-active-call-notify and storing:case 'rc-active-call-notify': ringCentralPhoneWidget.latestActiveCallTelephonyStatus = data.call && data.call.telephonyStatus ? data.call.telephonyStatus : "";break;Then during rc-call-end-notify, we determine whether the call should be saved as missed/incoming.Problem observed:In several debugging scenarios:Incoming call arrives rc-active-call-notify fires with: telephonyStatus = "Ringing" User answers the call on mobile or RC desktop Instead of receiving another rc-active-call-notify with a connected state, we directly receive: rc-call-end-notify At this point: latestActiveCallTelephonyStatus is still "Ringing" or sometimes null UI answer button may still be visible CRM incorrectly logs the call as missed We also noticed behavior changes while debugging:With breakpoints/debugger enabled, sometimes the correct event arrives later Without debugger, the issue reproduces mo

I have a TAPI application that makes my phone accessible to someone with low to no vision. This TAPI application allows me to control the phone via keyboard. A requirement of the TAPI application is that it needs a TAPI driver. Does ring central have a TAPI driver that I can use so this TAPI application - accessaphone - can control my ring central phone?

Hi, Completely new to webhooks but had hit a issue with my code. I have set up a webhook that sends a notification that a new call is presented (This works fine)I then have another Webhook that will tell me the status, the callers number and Handled by, The handled by is where I’m having an issue. I have successfully had #agent_username# work but only want to show agent full name.Ive tried #agent_full_name# and #agent_first_name# #agent_last_name# Does anyone have any suggest or a list of values that can be used. Code below: {  "cardsV2": [    {      "cardId": "alert-001",      "card": {        "sections": [          {            "widgets": [              {                "decoratedText": {                  "topLabel": "Alert Status",                  "text": "<b>Call Answered</b>",                  "startIcon": { "knownIcon": "PHONE" }                }              },              {                "decoratedText": {                  "topLabel": "Caller Number",           

I am needing assistance trying to setup a 3rd party SIP on UnifiTalk - for our Ring Central Account. UnifiTalk has the ability to add custom SIP provider but I am not sure what the specific key are.I have the details but not sure what fields to create on the Unifi side. SIP Domain              sip.ringcentral.com:5060Remote SIP port         5060Local SIP port          5060Outbound Proxy          Please select outbound proxy according to the location of your deviceOutbound Proxy Port     5096User Name               1########### (phone)Password                CPwdeeeeAuthorization ID        123425566 I am needing these converted to I guess what is expected by RingCentral. Is this documented anywhere????<SIP_domain><Remote_SIP_port><VoIP_Registrations><Protocol>SIP</Protocol><RegServer>sip.ringcentral.com</RegServer><RegClient>19546031388@sip.ringcentral.com</RegClient><LocalAlias>19546031388@99.27.55.122</LocalAlias>