# Chat Channel Scopes

**URL:** <https://devforum.zoom.us/t/chat-channel-scopes/6558>\
**Category:** API and Webhooks\
**Created:** [November 7, 2019, 6:36pm UTC](https://devforum.zoom.us/t/chat-channel-scopes/6558 "2019-11-07T18:36:24Z")\
**Posts on this page:** 14\
**Page:** 1

<div class="post-metadata">

**Author:** ![ian](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/ian/32/2296_2.png) [@ian](https://devforum.zoom.us/u/ian)\
**Post date:** [November 7, 2019, 6:36pm UTC](https://devforum.zoom.us/t/chat-channel-scopes/6558/1 "2019-11-07T18:36:24Z")

</div>

I have a valid token and am able to call other endpoints however when trying to obtain a list of channels for this user via [https://api.zoom.us/v2/chat/users/me/channels](https://api.zoom.us/v2/chat/users/me/channels)

I get the following returned:

{  
“code”: 4700,  
“message”: “Invalid access token, does not contain scopes: [chat\_channel:read, chat\_channel:write, zms:chat\_channel:read, zms:chat\_channel:write]”  
}

However I do not see in the list of scopes for my application where I can specify any of these scopes? I have request all possible scopes in the list as follows:

account:master account:read:admin account:write:admin billing:master contact:read:admin dashboard:master dashboard\_crc:read:admin dashboard\_home:read:admin dashboard\_im:read:admin dashboard\_meetings:read:admin dashboard\_webinars:read:admin dashboard\_zr:read:admin group:master group:read:admin group:write:admin h323:read:admin h323:write:admin imchat:bot imchat:read:admin imchat:write:admin imcontact:read:admin imgroup:master imgroup:read:admin imgroup:write:admin meeting:master meeting:read:admin meeting:write:admin pac:master pac:read:admin pac:write:admin phone:read:admin phone:write:admin recording:master recording:read:admin recording:write:admin report:master report:read:admin role:master role:read:admin role:write:admin room:read:admin scim2 sip\_phone:read:admin sip\_phone:write:admin tracking\_fields:master tracking\_fields:read:admin tracking\_fields:write:admin tsp:master tsp:read:admin tsp:write:admin user:master user:read:admin user:write:admin webinar:master webinar:read:admin webinar:write:admin

I am using oAuth flow using grant\_type = authorization\_code

I have also tried this from the test widget on [https://marketplace.zoom.us/docs/api-reference/zoom-api/chat-channels/getchannels](https://marketplace.zoom.us/docs/api-reference/zoom-api/chat-channels/getchannels) (even generating a new token) and I get the same response.

How do I add these additional scopes?

---

<div class="post-metadata">

**Author:** ![ian](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/ian/32/2296_2.png) [@ian](https://devforum.zoom.us/u/ian)\
**Post date:** [November 7, 2019, 6:48pm UTC](https://devforum.zoom.us/t/chat-channel-scopes/6558/2 "2019-11-07T18:48:55Z")

</div>

> [@ian](#):
>
> chat\_channel:read, chat\_channel:write, zms:chat\_channel:read, zms:chat\_channel:write

I have even tried to specify the scopes in the install URL but get the following:

Invalid scope: as current client hasn’t this approved scope! (4,700)

However it does actually still return a valid access\_token but without the channels scopes!

---

<div class="post-metadata">

**Author:** ![tommy](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/tommy/32/72769_2.png) [@tommy](https://devforum.zoom.us/u/tommy)\
**Post date:** [November 7, 2019, 6:52pm UTC](https://devforum.zoom.us/t/chat-channel-scopes/6558/3 "2019-11-07T18:52:10Z")

</div>

Hey @ian,

I am guessing you are using an Account Level OAuth App. To use the [Chat](https://marketplace.zoom.us/docs/api-reference/zoom-api/chat-messages) and [Channels](https://marketplace.zoom.us/docs/api-reference/zoom-api/chat-channels) APIs, you must use a [User-Managed OAuth app](https://marketplace.zoom.us/docs/guides/getting-started/app-types/create-oauth-app#register-your-app).

 ![11%20AM](https://us1.discourse-cdn.com/flex016/uploads/zoomdeveloper/original/2X/8/8e1d7b21c48388ee90e761f941da0b46819c1a03.png)

Let me know if this helps!

Thanks,  
Tommy

---

<div class="post-metadata">

**Author:** ![ian](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/ian/32/2296_2.png) [@ian](https://devforum.zoom.us/u/ian)\
**Post date:** [November 7, 2019, 6:57pm UTC](https://devforum.zoom.us/t/chat-channel-scopes/6558/4 "2019-11-07T18:57:18Z")

</div>

Make sense Tommy, although I was hoping that Zoom supported admin consent on behalf of users so that individual users did not have to install the app individually. We have 12k+ employee and I was hoping that account level app would solve this issue.

Is this something that you are looking to support at some stage?

---

<div class="post-metadata">

**Author:** ![tommy](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/tommy/32/72769_2.png) [@tommy](https://devforum.zoom.us/u/tommy)\
**Post date:** [November 7, 2019, 7:53pm UTC](https://devforum.zoom.us/t/chat-channel-scopes/6558/5 "2019-11-07T19:53:21Z")

</div>

Hey @ian,

We understand the limitation here, and will have Account Level Chat / Channel APIs sometime in the future.

[You can keep an eye on our releases here.](https://marketplace.zoom.us/docs/changelog)

Although, sending [Chatbots messages is Account Level](https://marketplace.zoom.us/docs/guides/getting-started/app-types/create-chatbot-app), and there are some special features like [listing channels and members of a channel.](https://marketplace.zoom.us/docs/guides/chatbots/customizing-messages/message-with-dropdown#dynamic-dropdowns)

Can you share your use case so I can try to come up with a solution in the meantime?

Thanks,  
Tommy

---

<div class="post-metadata">

**Author:** ![harris](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/harris/32/4331_2.png) [@harris](https://devforum.zoom.us/u/harris)\
**Post date:** [March 27, 2020, 7:14pm UTC](https://devforum.zoom.us/t/chat-channel-scopes/6558/6 "2020-03-27T19:14:48Z")

</div>

@Ian is right, it’s pretty limiting without account-level-oauth being able to get this information.

We’re looking to get specific channel information and I can’t seem to do that since I run into the same issue Ian ran into.

---

<div class="post-metadata">

**Author:** ![tommy](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/tommy/32/72769_2.png) [@tommy](https://devforum.zoom.us/u/tommy)\
**Post date:** [March 27, 2020, 10:45pm UTC](https://devforum.zoom.us/t/chat-channel-scopes/6558/7 "2020-03-27T22:45:38Z")

</div>

Hey @harris,

Yes, we are developing account level Chat APIs and should have them released in the coming months.

Stay update here: [https://marketplace.zoom.us/docs/changelog](https://marketplace.zoom.us/docs/changelog)

Thanks,  
Tommy

---

<div class="post-metadata">

**Author:** ![emata\_zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/emata_zoom/32/4587_2.png) [@emata\_zoom](https://devforum.zoom.us/u/emata_zoom)\
**Post date:** [March 31, 2020, 9:31pm UTC](https://devforum.zoom.us/t/chat-channel-scopes/6558/8 "2020-03-31T21:31:32Z")

</div>

Totally agree with @ian and harris, having account level access to “Chat Channels” and “Chat messages” endpoints will be a tremendous addition.

While calling the API today, I found that new permissions got listed as part of an error message; to be more specific **chat\_channel:write:admin and chat\_channel:read:admin** @tommy is there a way to add those scopes to an existing application or is that part of the incoming changes you have mentioned?

By the way @tommy , are “IM Chat Session” identifiers (from v1) going to match Chat Channel identifiers (from v2)? I am wondering to know if we are going to be able to get members for a given old session id.

Regards and thanks in advance for any related information.

---

<div class="post-metadata">

**Author:** ![tommy](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/tommy/32/72769_2.png) [@tommy](https://devforum.zoom.us/u/tommy)\
**Post date:** [April 1, 2020, 7:01am UTC](https://devforum.zoom.us/t/chat-channel-scopes/6558/9 "2020-04-01T07:01:54Z")

</div>

Hey @emata_zoom,

Yes I am also very excited for the Account Level Chat / Channel endpoint release! 🙂

You will be able to add the scopes to an existing Chatbot or Account Level OAuth app.

> [@emata\_zoom](#):
>
> By the way @tommy , are “IM Chat Session” identifiers (from v1) going to match Chat Channel identifiers (from v2)? I am wondering to know if we are going to be able to get members for a given old session id.

Not sure, can you send me an example of a v1 identifier?

Thanks,  
Tommy

---

<div class="post-metadata">

**Author:** ![emata\_zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/emata_zoom/32/4587_2.png) [@emata\_zoom](https://devforum.zoom.us/u/emata_zoom)\
**Post date:** [April 1, 2020, 2:23pm UTC](https://devforum.zoom.us/t/chat-channel-scopes/6558/10 "2020-04-01T14:23:00Z")

</div>

Hi @tommy,

Here is a example of a session in API v1:

> ```
> {
> "last_message_sent_time": "2019-09-01T09:59:22Z",
> "name": "user@domain",
> "session_id": "80b1889a6c82fb4484f7a0b702e517e3b8429ba17e566e201d64818eb924d508",
> "type": "1:1"
> }
> 
> ```

We also use that session id to get all the messages within the session (channel). So, we are wondering if we will be able to use that same session id to get the members of each 1:1 or “multi party” conversation.

Best regards.

---

<div class="post-metadata">

**Author:** ![tommy](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/tommy/32/72769_2.png) [@tommy](https://devforum.zoom.us/u/tommy)\
**Post date:** [April 1, 2020, 10:20pm UTC](https://devforum.zoom.us/t/chat-channel-scopes/6558/11 "2020-04-01T22:20:31Z")

</div>

Hey @emata_zoom,

I am guessing that is the `id` in our new [Chat Messages endpoints](https://marketplace.zoom.us/docs/api-reference/zoom-api/chat-messages/getchatmessages).

Can you test them to see if it matches?

Thanks,  
Tommy

---

<div class="post-metadata">

**Author:** ![emata\_zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/emata_zoom/32/4587_2.png) [@emata\_zoom](https://devforum.zoom.us/u/emata_zoom)\
**Post date:** [April 2, 2020, 2:09pm UTC](https://devforum.zoom.us/t/chat-channel-scopes/6558/12 "2020-04-02T14:09:25Z")

</div>

Hi @tommy

Unfortunately we can’t test that now because we only have an account level app token. Looking forward to test those new endpoints as soon as you release account level access for Chat and Channels v2 😀

Regards.

---

<div class="post-metadata">

**Author:** ![tommy](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/tommy/32/72769_2.png) [@tommy](https://devforum.zoom.us/u/tommy)\
**Post date:** [April 2, 2020, 11:05pm UTC](https://devforum.zoom.us/t/chat-channel-scopes/6558/13 "2020-04-02T23:05:47Z")

</div>

Sounds good @emata_zoom! 🙂

-Tommy

---

<div class="post-metadata">

**Author:** ![DeveloperBot](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/developerbot/32/12632_2.png) [@DeveloperBot](https://devforum.zoom.us/u/DeveloperBot)\
**Post date:** [August 21, 2020, 8:14pm UTC](https://devforum.zoom.us/t/chat-channel-scopes/6558/14 "2020-08-21T20:14:42Z")

</div>


