# Suggestion to fix Webhook documentation on VoiceMail Received webhook

**URL:** <https://devforum.zoom.us/t/suggestion-to-fix-webhook-documentation-on-voicemail-received-webhook/59952>\
**Category:** API and Webhooks\
**Created:** [November 8, 2021, 10:05pm UTC](https://devforum.zoom.us/t/suggestion-to-fix-webhook-documentation-on-voicemail-received-webhook/59952 "2021-11-08T22:05:55Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![pete\_h](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/pete_h/32/30310_2.png) [@pete\_h](https://devforum.zoom.us/u/pete_h)\
**Post date:** [November 8, 2021, 10:05pm UTC](https://devforum.zoom.us/t/suggestion-to-fix-webhook-documentation-on-voicemail-received-webhook/59952/1 "2021-11-08T22:05:55Z")

</div>

Check this post where the OP gets confirmation that the behavior has changed:

> [@Zoom phone 'phone.voicemail\_received' event unexpectedly changed structure](https://devforum.zoom.us/t/zoom-phone-phone-voicemail-received-event-unexpectedly-changed-structure/47738):
>
> We started getting surprise errors in our application on April 9th regarding voicemails. It seems like the structure of the event has changed unexpectedly. Specifically, the callee\_user\_id field has been renamed to just callee\_id in the phone.voicemail\_received webhook event. Were there any release notes or notification channels we could have used to be aware of this upcoming change? There isn’t any mention of it in any of the changelogs.

The next step for your documentation team would be to add that tidbit to the documentation. Even the explanation of the behavior from the Staff person wasn’t completely accurate. He said this:

"In instances where the voicemail is left to the AutoReceptionist, CallQueue, or SharedLineGroup, the `callee_user_id` will be _empty_ . Regarding `callee_id` this field is used (along with callee\_extension\_type) to identify the voicemail owner’s information. E.g.:

`"callee_extension_type":"string"` //user, callQueue, autoReceptionist, shareLineGroup

`"callee_id":"string"` //user: user\_id(= callee\_user\_id); callQueue: group\_id; autoReceptionist: auto\_receptionist\_id; shareLineGroup: share\_line\_group\_id"

What I have seen is that the callee\_user\_id isn’t just empty, it’s completely missing from the json in the payload. Adding that detail would prevent the occasional failures I was seeing in the webhook calls.

Thanks

---

<div class="post-metadata">

**Author:** ![will.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/will.zoom/32/14417_2.png) [@will.zoom](https://devforum.zoom.us/u/will.zoom)\
**Post date:** [November 10, 2021, 1:24pm UTC](https://devforum.zoom.us/t/suggestion-to-fix-webhook-documentation-on-voicemail-received-webhook/59952/2 "2021-11-10T13:24:41Z")

</div>

Hi @pete_h,

Thank you for this feedback, and for pointing that out. I will request our documentation team to make this clearer in our docs.

Many thanks for the diligence in following up on this topic. 🙂

-Will

---

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/flex016/uploads/zoomdeveloper/original/3X/6/1/614bdd549b610bbaa46ff934617683a02bdaa03c.png) [@system](https://devforum.zoom.us/u/system)\
**Post date:** [December 10, 2021, 11:24pm UTC](https://devforum.zoom.us/t/suggestion-to-fix-webhook-documentation-on-voicemail-received-webhook/59952/3 "2021-12-10T23:24:55Z")

</div>

Closed on December 10, 2021, 11:24pm UTC

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.
