Skip to main content
Question

Verification-Token on webhooks always empty

  • February 27, 2026
  • 3 replies
  • 7 views

I created a webhook subscription like such:

{

    "expiresIn": 315360000,

    "eventFilters": [

        "/restapi/v1.0/account/~/extension/~/message-store"

    ],

    "deliveryMode": {

        "transportType": "WebHook",

        "address": "URL",

        "Verification-Token":"Rar0vqXaRtqHKlhc6adZJrX1SpkikugxoJ6iXxdblrwqiHtvsr2QkD3pLPu9Iumk"

    }

}
 

but actual webhooks continue to send verification-token as empty field. I tried naming the field verificationtoken, I tried removing it all together. They’ve had no effect. The documentation doesn’t provide much detail so I’m shooting in the dark. 

 

My goal is to get Fax status updates.

3 replies

PhongVu
Community Manager
Forum|alt.badge.img
  • Community Manager
  • February 27, 2026

When you create your webhook, you set the verificationToken and the verification token will be included in the post request header name Verification-Token when you receive an event. It’s documented here.


https://developers.ringcentral.com/guide/notifications/webhooks/receiving
“When we setup the WebHook, we include deliveryMode.validationToken in the request body. And whenever a webhook is sent, there will be a Validation-Token in the headers:”


  • Author
  • New Participant
  • February 27, 2026

hi PhongVu, thank you, but that’s what I meant, it’s always passed with empty string when an event takes place, which is making my webhook validation fail. Setting the verification token during create results in no verification token during an event…. not setting verification token during create *also* results in no verification token during an event.


PhongVu
Community Manager
Forum|alt.badge.img
  • Community Manager
  • February 27, 2026

hi PhongVu, thank you, but that’s what I meant, it’s always passed with empty string when an event takes place, which is making my webhook validation fail. Setting the verification token during create results in no verification token during an event…. not setting verification token during create *also* results in no verification token during an event.

Because you passed the wrong name, it must be verificationToken, no hyphen. Don’t you see that?

"deliveryMode": {

        "transportType": "WebHook",

        "address": "URL",

        "Verification-Token":"Rar0vqXaRtqHKlhc6adZJrX1SpkikugxoJ6iXxdblrwqiHtvsr2QkD3pLPu9Iumk"

    }