News & Announcements User Community Developer Community

Welcome to the RingCentral Community

Please note the community is currently under maintenance and is read-only.

Make sure to review our Terms of Use and Community Guidelines.
  Please note the community is currently under maintenance and is read-only.
Home » Developers
Will an extensionId ever get reused/resassigned to another user?
Tags: analytics and reporting, rest api
Jan 7, 2022 at 2:56pm   •   1 replies  •  0 likes
Chris Harmon

I'm working on pulling call & message activity into our data warehouse via the RingCentral APIs. I'm currently consuming the following APIs:

- Get Company Call Log Records
- Message Store - Get Message List
- Get Extension List (also necessary in order to get Message Store data, because that API requires iterating over extensions to get all messages company-wide)
- Get Company Directory Entries

I already know that we intend to recycle extension numbers over time as folks come & go from the company. Therefore, I need to account for the fact that for any given extensionId, the extension number could change, thereby affecting my ability to link historical calls to the correct person if I'm not careful. (I'm planning on treating the extensions as a Type 2 slowly-changing dimension table on my end to handle this.)

However, what I don't know is the lifecycle of an extension record itself, based on the extensionId. So, I'm looking for some clarity on that.

Let's assume my own RingCentral extension looks like this in the Get Extension List API:

  "id": 123456789,
  "extensionNumber": "420",
  "contact": {
    "firstName": "Chris",
    "lastName": "Harmon",
    "jobTitle": "Data Engineer",
    "department": "Foo Corp",
    "email": "",
    "emailAsLoginName": true,
    "pronouncedName": {
      "type": "Default",
      "text": "Chris Harmon"
  "name": "Chris Harmon",
  "type": "User",
  "status": "Enabled",
  "permissions": {
    "admin": {
      "enabled": true
    "internationalCalling": {
      "enabled": true
  "hidden": false

As mentioned above, I already know that extensionNumber 420 will eventually be recycled & assigned to someone else if I leave the company.

My questions are:

1. If I leave the company, what happens to the RingCentral extension record with extensionId 123456789? Does it remain associated with my user forever, or does it go back into a pool of available extensions to be reassigned to someone else?

2. Is it possible that extensionId 123456789 could be reassigned to a different user (and myself reassigned to a different extensionId) while I'm still at the company?

1 Answer
answered on Jan 8, 2022 at 10:30am  

I am quite sure that the extensionId (123456789) will not be recycled. It is a unique id that the system generated when an extension is created and cannot be modified afterward. The extensionNumber is automatically assigned by the system when an extension is created and setup, but it can be changed by a super admin user during the creation process and after the extension is created.

Thus, you can rely on the extensionId to identify a unique user under an account w/o worrying about duplication.


A new Community is coming to RingCentral!

Posts are currently read-only as we transition into our new platform.

We thank you for your patience
during this downtime.

Try Workflow Builder

Did you know you can easily automate tasks like responding to SMS, team messages, and more? Plus it's included with RingCentral Video and RingEX plans!

Try RingCentral Workflow Builder

Developer Platform
Integrated Apps
App Gallery
Developer support
Games and rewards

Resource center
Product Releases
App Download
RingCentral App login
Admin Portal Login
Contact Sales
© 1999-2024 RingCentral, Inc. All rights reserved. Legal Privacy Notice Site Map Contact Us