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
Webhook Subscription for phoneNumber Changes
Tags: webhooks, subscription
Apr 25, 2022 at 3:22pm   •   1 replies  •  0 likes
Paul Rarey

Hey All... We are looking for a Notification type that will inform us of:

  1. Newly purchased phoneNumber(s) arrive in our Inventory (unassigned), available for assignment.
  2. phoneNumber(s) are released back to RingCentral/Carrier.
  3. A phoneNumber is unassigned from an ExtensionID and returns to Inventory (unassigned)
    Assume either
    a) The ExtensionID was deleted (phoneNumber returned to Inventory) or,
    b) The phoneNumber was simply removed/unassigned from the ExtensionID.

We subscribe to ~/restapi/v1.0/account/~/extension, and do receive Events listed in its API Reference page, except the Unassigned event for case a) and b) [ list item > phone numbers (assign/unassign) ]. We will be debugging that a bit more, collecting details for a service ticket if needed.

We need guidance on items 1 & 2 above; what Notification type would generate those Events?

Thanks in advance!


1 Answer
answered on Apr 26, 2022 at 9:54am  

To the best of my knowledge, we do not have any Phone Number events one can subscribe to. But what I would like to suggest is that you submit this idea to the RingCentral Ideas Portal so that we can route the idea to the right team to implement.

In the meantime, I want to make sure you are aware of this API call:

This API will allow you to retrieve a list of all phone numbers in an account. Look at the usageType parameter. Unused numbers may be found with a usageType of NumberPool. Unfortunately, you cannot filter by this usage type (a separate idea you might want to submit to the ideas portal btw). But you could generate the full list of numbers, iterate over the list, and pluck out the unused ones.

In summary - currently, you will need to create your own logic for iterating over all phone numbers looking for unused ones.

on Apr 29, 2022 at 12:31pm   •  0 likes

Hey @Byrne Reese - We use the following endpoints extensively

  1. ~/restapi/v1.0

  2. ~/account/~/phone-number

  3. ~restapi/v1.0/account/~/phone-number/$phnID

  4. ~/restapi/v1.0/account/~/extension

  5. ~/restapi/v1.0/account/~/extension/$extID/phone-number

  6. ~/restapi/v2/accounts/~/phone-numbers

    6 Supports: PATCH for assign/reassign phoneNumerID to/from extensionID | Filter: ?usageType=Inventory

The Subscription (Webhook) we use is ~/api-reference/Extension-List-Event, which is supposed to send event notices for "phone numbers (assign/unassign)"

We are not seeing those event Hints in our Webhook receiver/endpoint. We are seeing the other events/notices listed for the method in the API Reference.

Should I submit a support ticket on this?

Thanks in advance!

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