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
API Local Number Provisioning
Tags: rest api
Oct 13, 2021 at 2:47pm   •   3 replies  •  0 likes
Jon Moubayed


I am trying to automate our provisioning process through the API and we currently assign local numbers to each user. From the documentation I can only find a way to create a user with an extension, or create a user and have it randomly assign a number in the available unassigned pool.

Is there a way to create local numbers and user?

3 Answers
answered on Sep 14, 2023 at 1:14pm  


Here's how we're doing it:

1). Use "List Company Phone Numbers" API and select the appropriate flags under UsageType to list the numbers you need. Gather the internal number ID for the number you want.
2). Create extension - gather extensionID from response body
3). Create BYOD device (type "OtherPhone") and assign to the extensionID from step 1. Attach the internal number id from step 1. This will add an RC App with DL and phone number to the extension from step 2. If you need to attach a physical phone to the extension, capture the internal device ID and proceed to step 4. Otherwise, you're done.
4). You will need the internal device ID of the hardphone you wish to swap for the Softphone created in step 3. You can get this by using GET "{ {serial}}" (double braces for Postman)

5). Swap phones with the target device ID being the one you grabbed from step 4, and device ID being the internal ID from step 3.

You now have a hardphone with the desired phone number assigned to the extension you just created.

answered on Oct 14, 2021 at 7:57am  

@Anirban yes that is currently what we are doing but it looks like that might be the only way right now.

answered on Oct 13, 2021 at 3:37pm  

I am not sure you can create a local number by api however you can create user or extension with api and assign the user or extension with an existing number by updating with api which maybe you are doing now


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