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
My webhook subscription is blocked/blacklisted. What do I do?
Tags: webhooks
Jul 7, 2022 at 7:35am   •   2 replies  •  0 likes

We have created an app 'Webhook Notifications with JWT' for missed calls and voicemail notifications. We have authenticated the app using JWT auth. The subscription's ID is 8172fec1-45ed-4e20-9ca1-af577793d61b.

The delivery address in the webhook is ngrok. The webhook seems to work perfectly but then after some time it gets blacklisted.

The reason is 'Webhook responses with code: [404], reason: [Not Found]'. Is there any way to check the reason behind a subscription getting blacklisted? And how do I keep my subscription from getting blacklisted?

2 Answers
answered on Sep 29, 2023 at 2:58pm  

Unfortunately, we do not provide developers with a detailed technical explanation of why a webhook subscription is blacklisted, but as Phong points out above, if you know the subscription ID of the webhook, then you get use the Get Subscription endpoint to retrieve a summary of why a subscription may be blocked.

Preventing a webhook URL from being blacklisted is made easier by knowing some of the reasons why a subscription may get blocked, for which there are two primary reasons:

  1. RingCentral has made attempts to deliver webhooks to a designated URL, but has received too many errors when attempting to do so. These errors could be any 40x or 50x error code. For ngrok users, that means that if your app is offline for too long, then a subscription is likely to be blocked at some point as RingCentral will be unable to reach your server.

  2. If the URL you have registered doesn't meet all technical requirements for a webhook, then RingCentral is likely to block the subscription. You can find a list of webhook technical requirements in our Developer Guide.

My webhook was working, is available, but I am still getting blocked. Some developers have pointed out that subscriptions that are working normally can, out of nowhere, become blocked. One reason this can happen relates to when the responses to a received webhook vary in size.

This is problematic because normally an app should not respond with any content when it receives a webhook. The app only needs to transmit an HTTP status code of 200 in response. However, if your app is unintentionally responding with a payload, and if that payload is larger than 1024 bytes, then your app will eventually be blocked. So if 99% of the time the payload is less than 1024 bytes and then all of a sudden the payload begins to exceed that threshold, it may appear that the URL is being blocked for no good reason.

How to recover from a blacklisted subscription If you find that your subscription has been blocked, then you can restore the stream of notifications simply by creating a new subscription. In other words, RingCentral does not blacklist URLs so much as we give up sending webhooks to servers that return errors or don't meet our requirements.

answered on Jul 7, 2022 at 8:03am  

Unfortunately, there is no way for developers to check the detailed reason of getting blacklisted. But, you can read the subscription and see the short description of the reason like this. E.g.

"blacklistedData": {
     "reason": "I/O operation is failed. Details: [Read timed out]",
     "blacklistedAt": "2022-06-28T05:24:00.720Z"

How often do you get your subscription blacklisted? Do you always send 200 response for every event? If not, please do so.

on Jul 7, 2022 at 8:33am   •  0 likes

Hi @Phong Vu ,

Yes, There is 200 response for every event.

Around 4 subscription blacklisted in last month and they were active for 1 day to 8 days.

on Jul 7, 2022 at 9:20am   •  0 likes

Can you test with a remote server also? I had the same issue long time ago and it was because of exceeding the rate limit of ngrok tunnel. I am not sure if it is your case or not, but it's worth to double check.

on Aug 18, 2022 at 8:48am   •  1 likes

Hi @Phong Vu ,

I have added webhook on remote server. Its working. Its been more than a month that webhook is active.

And on all blacklisted subscription became automatically active again.

Thank you!

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