ringcentral-webhooks

name	ringcentral-webhooks
description	Receive and verify RingCentral webhooks. Use when setting up RingCentral webhook subscriptions, completing the Validation-Token handshake, checking the Verification-Token header, or handling message-store, presence, and telephony session events.
license	MIT
metadata	{"author":"hookdeck","version":"0.1.0","repository":"https://github.com/hookdeck/webhook-skills"}

RingCentral Webhooks

When to Use This Skill

• How do I receive RingCentral webhooks?
• How do I complete the RingCentral Validation-Token handshake?
• How do I verify RingCentral notifications with a Verification-Token?
• How do I create a RingCentral subscription (POST /restapi/v1.0/subscription)?
• Why is my RingCentral subscription getting blacklisted?
• How do I handle message-store, presence, or telephony/sessions events?

Verification (core)

RingCentral does not HMAC-sign webhooks and does not follow the Standard Webhooks spec. Authenticity relies on two mechanisms:

1. Validation-Token handshake (mandatory). When a subscription is created or renewed, RingCentral sends a request carrying a Validation-Token request header. Your handler must echo that exact value back in a Validation-Token header and return — fast (within a few seconds). No body is required.