News & Announcements User Community Developer Community

Welcome to the RingCentral Community

Please note the community is currently under maintenance and is read-only.

Search
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 create webhook subscription, receiving 400 status code
Tags: webhooks
Sep 27, 2023 at 3:44pm   •   0 replies  •  0 likes
Byrne Reese

If you attempting to create a webhook subscription via the RingCentral Subscription API and are receiving a 400 HTTP status code, then chances are one of two things is going wrong.

Properly validate the webhook URL When you subscribe to an event via a webhook, RingCentral will attempt to validate the URL you specify in your subscription request. This validation step requires your application to respond to an incoming validation request in a prescribed way. Please consult our documentation on "validating webhook URLs upon subscription creation".

Ensure your webhook URL meets all requirements From the RingCentral Developer Guide:

When you create a webhook subscription, RingCentral will transmit a test request to the designated URL in an attempt to verify all of the following prior to creating the subscription and transmitting events.

  • The URL must accessible by RingCentral and not behind a firewall

  • The web server supports TLS 1.2 or higher (see note below about TLS support)

  • The web server must respond within 3000 milliseconds

  • The web server must respond with an HTTP status code of 200 OK

  • The web server must respond with a valid Validation-Token header

Call the Subscription API correctly It is important to rule out the possibility that you are unknowingly calling the Subscription API incorrectly. To rule this out, try creating a subscription via a simple demo application. If you are successful in creating a subscription using this demo app, then the most likely reason you are receiving an error is because you are not formatting your request properly.



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

PRODUCTS
RingEX
Message
Video
Phone
OPEN ECOSYSTEM
Developer Platform
APIs
Integrated Apps
App Gallery
Developer support
Games and rewards

RESOURCES
Resource center
Blog
Product Releases
Accessibility
QUICK LINKS
App Download
RingCentral App login
Admin Portal Login
Contact Sales
© 1999-2024 RingCentral, Inc. All rights reserved. Legal Privacy Notice Site Map Contact Us