# User API presense\_status doesn't match documentation

**URL:** <https://devforum.zoom.us/t/user-api-presense-status-doesnt-match-documentation/120100>\
**Category:** API and Webhooks\
**Created:** [October 31, 2024, 1:11am UTC](https://devforum.zoom.us/t/user-api-presense-status-doesnt-match-documentation/120100 "2024-10-31T01:11:56Z")\
**Posts on this page:** 9\
**Page:** 1

<div class="post-metadata">

**Author:** ![sswany](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/sswany/32/59997_2.png) [@sswany](https://devforum.zoom.us/u/sswany)\
**Post date:** [October 31, 2024, 1:11am UTC](https://devforum.zoom.us/t/user-api-presense-status-doesnt-match-documentation/120100/1 "2024-10-31T01:11:56Z")

</div>

When using the User API endpoint `/users/{userId}/presence_status` the information given only lists “Away,” “Available,” “Do\_Not\_Disturb,” and “Offline.” If you subscribe to the webhook events for presence updates, you get the full list that matches the documentation for the endpoint.

According to the documentation, the endpoint should have the same information available, but doesn’t seem to.

Is this a known issue?

---

<div class="post-metadata">

**Author:** ![gianni.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/gianni.zoom/32/32523_2.png) [@gianni.zoom](https://devforum.zoom.us/u/gianni.zoom)\
**Post date:** [October 31, 2024, 6:07pm UTC](https://devforum.zoom.us/t/user-api-presense-status-doesnt-match-documentation/120100/2 "2024-10-31T18:07:16Z")

</div>

Hi @sswany , thanks for bringing to our attention, we can submit for further inquiry with the API and respective documentation team. Can you share a screenshot of what you’re seeing?

---

<div class="post-metadata">

**Author:** ![sswany](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/sswany/32/59997_2.png) [@sswany](https://devforum.zoom.us/u/sswany)\
**Post date:** [October 31, 2024, 6:28pm UTC](https://devforum.zoom.us/t/user-api-presense-status-doesnt-match-documentation/120100/4 "2024-10-31T18:28:01Z")

</div>

Hi @gianni.zoom

This screenshot is for a user that’s currently `in_calendar_event` according to the webhook information, but this is what we get when using the api endpoint `users/{user_id}/presence_status`

 ![CleanShot 2024-10-31 at 11.25.19@2x](https://us1.discourse-cdn.com/flex016/uploads/zoomdeveloper/original/3X/d/0/d067c353acf85be065340720c5a9bc4a3098a3e5.png)

---

<div class="post-metadata">

**Author:** ![gianni.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/gianni.zoom/32/32523_2.png) [@gianni.zoom](https://devforum.zoom.us/u/gianni.zoom)\
**Post date:** [November 1, 2024, 8:38pm UTC](https://devforum.zoom.us/t/user-api-presense-status-doesnt-match-documentation/120100/5 "2024-11-01T20:38:57Z")

</div>

Hi @sswany , so I do not believe “in a calendar event” and “do not disturb” are mutually exclusive. For example, I can have something on my calendar while I set my Zoom Chat to “do not disturb”. I can inquire further about the logic to see if chat presence overrides default calendar status.

> [@sswany](#):
>
> When using the User API endpoint `/users/{userId}/presence_status` the information given only lists “Away,” “Available,” “Do\_Not\_Disturb,” and “Offline.”

Is the example you shared what led you to believe the this endpoint is only returning the following? Did the user set their chat status to do not disturb or are you saying they haven’t changed anything on chat and its’s returning DND even though it says in a calendar event on chat?

---

<div class="post-metadata">

**Author:** ![sswany](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/sswany/32/59997_2.png) [@sswany](https://devforum.zoom.us/u/sswany)\
**Post date:** [November 1, 2024, 9:40pm UTC](https://devforum.zoom.us/t/user-api-presense-status-doesnt-match-documentation/120100/6 "2024-11-01T21:40:54Z")

</div>

Hi @gianni.zoom

Your confusion is what lead to me posting this. Regardless of the actual `presence_status` the user currently has when using the `/users/{userId}/presence_status` endpoint, only a limited subset of statuses are returned that I mentioned.

If my status is currently “in\_a\_calendar\_event” when using the endpoint, I get “Do\_Not\_Disturb” instead. Only when the status is updated via the subscribed webhook information do I get the true presence status.

There doesn’t seem to be a way to call the endpoint get the true status. The screenshot I sent was for a user that was actually “in\_a\_calendar\_event” but that was what was returned.

---

<div class="post-metadata">

**Author:** ![gianni.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/gianni.zoom/32/32523_2.png) [@gianni.zoom](https://devforum.zoom.us/u/gianni.zoom)\
**Post date:** [November 13, 2024, 5:57pm UTC](https://devforum.zoom.us/t/user-api-presense-status-doesnt-match-documentation/120100/7 "2024-11-13T17:57:42Z")

</div>

Hi @sswany ,

> [@sswany](#):
>
> If my status is currently “in\_a\_calendar\_event” when using the endpoint, I get “Do\_Not\_Disturb” instead. Only when the status is updated via the subscribed webhook information do I get the true presence status.
> 
> There doesn’t seem to be a way to call the endpoint get the true status. The screenshot I sent was for a user that was actually “in\_a\_calendar\_event” but that was what was returned.

I see! Thanks for those additional details. Can you please reproduce the requests and I will use the trace id for further investigation? Please send all the below requested details in this private message I’ll initate:

- client id
- developer email
- API response
- zm-tracking-id from API response header
- screenshot of user status on chat client to show the discrepancy
- webhook screenshot and id

---

<div class="post-metadata">

**Author:** ![sswany](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/sswany/32/59997_2.png) [@sswany](https://devforum.zoom.us/u/sswany)\
**Post date:** [November 14, 2024, 8:35pm UTC](https://devforum.zoom.us/t/user-api-presense-status-doesnt-match-documentation/120100/8 "2024-11-14T20:35:44Z")

</div>

> [@gianni.zoom](#):
>
> - client id
> - developer email
> - API response
> - zm-tracking-id from API response header
> - screenshot of user status on chat client to show the discrepancy
> - webhook screenshot and id

Thank you Gianni. Just replied with the requested information.

---

<div class="post-metadata">

**Author:** ![gianni.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/gianni.zoom/32/32523_2.png) [@gianni.zoom](https://devforum.zoom.us/u/gianni.zoom)\
**Post date:** [November 19, 2024, 6:14pm UTC](https://devforum.zoom.us/t/user-api-presense-status-doesnt-match-documentation/120100/9 "2024-11-19T18:14:24Z")

</div>

Hi @sswany , this has been put into support for you where you will continue correspondence and escalations as needed (TS1538305). When concluded, please share your final updates in the thread. You can find notification of this in your email.

---

<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:** [November 23, 2025, 9:51am UTC](https://devforum.zoom.us/t/user-api-presense-status-doesnt-match-documentation/120100/10 "2025-11-23T09:51:12Z")

</div>

Closed on November 23, 2025, 9:51am UTC

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