Paul Rarey avatar image
Paul Rarey asked Paul Rarey edited

Webhook Subscription for phoneNumber Changes

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 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

1 Answer

Byrne Reese avatar image
Byrne Reese answered Paul Rarey edited

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.

1 comment
1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

Paul Rarey avatar image Paul Rarey commented ·

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!

0 Likes 0 ·

Developer sandbox tools

Using the RingCentral Phone for Desktop, you can dial or receive test calls, send and receive test SMS or Fax messages in your sandbox environment.

Download RingCentral Phone for Desktop:

Tip: switch to the "sandbox mode" before logging in the app:

  • On MacOS: press "fn + command + f2" keys
  • On Windows: press "Ctrl + F2" keys