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
unable to subscribe with all extensions defined as "~"
Tags: rest api
Aug 4, 2020 at 9:54am   •   3 replies  •  0 likes
Greenboard Dev Team

When we send POST request to /subscription endpoint

with this payload:

{'eventFilters': ['/restapi/v1.0/account/~/extension/~/missed-calls',
 'deliveryMode': {'transportType': 'WebHook',
  'address': 'https://1e............315',
  'verificationToken': '75...........2e986'},
 'expiresIn': 630720000}

the address is successfully registered

but it is then visible then like:

            "uri": "",
            "id": "626ea384-4576-433b-b9b2-44af300c561f",
            "creationTime": "2020-08-04T14:53:59.642Z",
            "status": "Active",
            "eventFilters": [
            "expirationTime": "2036-06-08T15:47:19.642Z",
            "expiresIn": 499998021,
            "deliveryMode": {
                "transportType": "WebHook",
                "encryption": false,
                "address": "https://1............315"

why '~' was replaced with 2460...020 and 2744...015?

I wanted to register for a subscription of events about all phone numbers/extensions.

3 Answers
answered on Aug 5, 2020 at 8:12am  

@Phong VuOn production env I log in with non-admin account.

but I've checked on sandbox with an admin account, and I see the same exception:

ApiException: Not allowed subscribe for missed calls of another extension

answered on Aug 4, 2020 at 11:41am  

@Phong Vu thank you

however, following you and registering filters for all extensions

I have to use extension level because account level is invalid for my filters

Also, I see:
ApiException: Not allowed subscribe for missed calls of another extension

and the same for incoming-calls

so how can I register all extensions for one single API application?

am I supposed to repeat registration from every account being logged into API.

this is not available to me, it must be one account with granted permissions.

answered on Aug 4, 2020 at 10:26am  

The tilde "~" will be converted to an id based on the access token information. So in the backend, it will be replaced with the account id and extension id of the user/extension, who logs in the app. And in your case, the user you logged in.

If you want to register for other extensions (or all extensions), first check the API reference to see if it there is a filter for the account level (for example the presence notification supports an account level "/restapi/v1.0/account/{accountId}/presence"). For some filters such as the telephony session event, you can register for other extensions by specifying multiple filter with the exact extension id in each filter. In that case, you can read the account's extension list and capture the extension ids and specify them in your filters.

I have some explanation about registering multiple extensions notification in this blog. So check it out.


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