article

Byrne Reese avatar image
Byrne Reese posted

Cannot create webhook subscripton. My limit has been exceeded.

There exists a limit of 20 subscriptions per user per app at any given time. When this limit is exceeded, then the following error will be returned.

 { 
     "errorCode":"SUB-505" 
     "message":"Subscriptions limit exceeded" 
     "errors":[{ 
         "errorCode":"SUB-505" 
         "message":"Subscriptions limit exceeded" 
     }] 
 }

Do not dismay, there are a few remedies to this that are relatively simple to implement.

Delete unused subscriptions

This is relatively obvious I suppose, but the simplest thing to do is delete any and all unused subscriptions, which during active development of an application can inadvertantly accummulate without one knowing.

RingCentral does not yet expose a tool or user interface for developers to use for this purpose, so you will need to call the API to generate a list of subscriptions, and then again to delete/cancel unwanted subscriptions.

Combine or coalesce subscriptions

A often under-utilized feature of RingCentral's Subscription API is the ability to subscribe to multiple events via the same subscription. This is achieved by passing in multiple event filters in your create subscription request.

This is much more economical and will allow you to reclaim some of your subscription capacity.

Be mindful of subscription expirations

It is tempting to set an expiration date for a webhook subscription so far in the future it effectively never expires. If you do this too often, it increases the chance of exceeding your subscription limit for any given user. Using expiration dates more mindfully, especially during development, will allow older subscriptions to expire and be reaped by the system more naturally.

webhooks
1 |3000

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

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

Article

Contributors

ByrneReese contributed to this article