Will Webhook become inactive at any point after the successful subscription.

  • 1
  • Question
  • Updated 9 months ago
  • (Edited)
Let's say I have a webhook subscribed at the RingCentral for receiving the call events. I am successfully receiving the call events. I want to know if the webhook will become inactive / blacklisted at any point after the successful subscription? If so, what could be the reasons for that ?

If it becomes inactive/blacklisted, how it can be reactivated again ?
Photo of Jayakumar I

Jayakumar I

  • 70 Points

Posted 9 months ago

  • 1
Photo of Igor Bebin

Igor Bebin, Official Rep

  • 860 Points 500 badge 2x thumb
Hi Jayakumar,

Yes, we have blacklisting rules for Webhooks, since Webhook subscription has pretty long expiration period (up to 15 years).

There are several requirements to your Webhook URL:
  1. It's available on the Internet
  2. It can respond within 3000 milliseconds 
... and some other, specified in

If WebHook url doesn't meet above requirements during 10 minutes subscription became blacklisted. Subscription became Active during reconcilation (every 15 minutes) if WebHook url became valid.

blacklistedData is available for blacklisted WebHook subscriptions, you can retrieve it as part of Subscription List API response, see https://developers.ringcentral.com/api-docs/latest/index.html#!#RefGetSubscriptionList

"blacklistedData": {
"reason": "Webhook responses with code: [404], reason: [Not Found]",
"blacklistedAt": "2018-08-03T12:44:03.105Z" 
Photo of John Wang

John Wang, Official Rep

  • 5,826 Points 5k badge 2x thumb
As mentioned by Igor, a WebHook can become blacklisted when the endpoint is unresponsive.

For me, this can happen when I'm doing development on my laptop and I shutdown the service and/or laptop. To deal with this, I built a small command line app that will list subscriptions and "recreate" them with the same endpoint if they become blacklisted (create a new one and delete the old one) so you can move forward to development instead of waiting for a webhook to get off the blacklist. You can get this here: