# Missing granular scopes in scope selection for Chat API

**URL:** <https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270>\
**Category:** API and Webhooks\
**Tags:** api\
**Created:** [June 20, 2024, 7:23am UTC](https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270 "2024-06-20T07:23:52Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![joe.smithinc12123](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/joe.smithinc12123/32/60760_2.png) [@joe.smithinc12123](https://devforum.zoom.us/u/joe.smithinc12123)\
**Post date:** [June 20, 2024, 7:23am UTC](https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270/1 "2024-06-20T07:23:52Z")

</div>

I am trying to use Zoom’s Chat API with an Oauth application as authentication(right now in development stage). The app is “Admin-managed”, as i need to access all users’ data in my account.

Most endpoint work, like [Create a channel](https://developers.zoom.us/docs/api/rest/reference/chat/methods/#operation/createChannel), meaning its not a problem in the Oauth flow.

When trying to call endpoints such as [Get a Channel](https://developers.zoom.us/docs/api/rest/reference/chat/methods/#operation/getUserLevelChannel) i get an error telling me that the token i am using doesn’t have the `team_chat:read:channel` scope. When trying to add to my app this scope i only see the `team_chat:read:channel:admin` scope. Even with this scope the endpoint refuses to work.

This happens in other endpoints such as [Delete a channel](https://developers.zoom.us/docs/api/rest/reference/chat/methods/#operation/deleteUserLevelChannel).

Has any one also come across this? any suggestions?

Thanks

---

<div class="post-metadata">

**Author:** ![elisa.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/elisa.zoom/32/47836_2.png) [@elisa.zoom](https://devforum.zoom.us/u/elisa.zoom)\
**Post date:** [July 2, 2024, 2:50pm UTC](https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270/2 "2024-07-02T14:50:13Z")

</div>

Hi @joe.smithinc12123  
Thanks for reaching out to us and welcome to our Zoom Developer Community, I am happy to help here!

Have you been able to troubleshoot this on your end? please let me know if you still need help so I can try and replicate this behavior

Cheers,  
Elisa

---

<div class="post-metadata">

**Author:** ![joe.smithinc12123](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/joe.smithinc12123/32/60760_2.png) [@joe.smithinc12123](https://devforum.zoom.us/u/joe.smithinc12123)\
**Post date:** [July 9, 2024, 9:30am UTC](https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270/3 "2024-07-09T09:30:55Z")

</div>

Hey,  
thank you for the reply.  
i have tried rerunning and recreating everything and still get the same situation mentioned above.  
I would greatly appreciate any help as i am really not sure what else i can do.  
thanks.

---

<div class="post-metadata">

**Author:** ![elisa.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/elisa.zoom/32/47836_2.png) [@elisa.zoom](https://devforum.zoom.us/u/elisa.zoom)\
**Post date:** [July 9, 2024, 6:34pm UTC](https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270/4 "2024-07-09T18:34:12Z")

</div>

Hi @joe.smithinc12123  
I can replicate the error you are getting when calling the Get a Channel endpoint with an OAuth admin-managed app.

So, what I did to Get a channel with an admin-managed app is that I used the endpoint [Get users channels](https://developers.zoom.us/docs/api/rest/reference/chat/methods/#operation/getChannels) endpoint instead.

You get the same data so you should be able to get all your users data with that endpoint  
could you please review this and let me know if that works for you

---

<div class="post-metadata">

**Author:** ![joe.smithinc12123](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/joe.smithinc12123/32/60760_2.png) [@joe.smithinc12123](https://devforum.zoom.us/u/joe.smithinc12123)\
**Post date:** [July 14, 2024, 8:56am UTC](https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270/5 "2024-07-14T08:56:38Z")

</div>

Hey again,  
The endpoint you sent works but it serves a different purpose, it lists all channels for a given user. The way i understand it the [Get Channel](https://developers.zoom.us/docs/api/rest/reference/chat/methods/#operation/getUserLevelChannel) endpoint returns channel information for a given channel ID, which is the functionality i am looking for.

Are there any plans to add the missing scope/scopes in the future? if so i can go over all my findings and provide a full list of scopes i came a cross that are missing.  
Thank you for your help.

---

<div class="post-metadata">

**Author:** ![joe.smithinc12123](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/joe.smithinc12123/32/60760_2.png) [@joe.smithinc12123](https://devforum.zoom.us/u/joe.smithinc12123)\
**Post date:** [July 24, 2024, 6:12am UTC](https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270/6 "2024-07-24T06:12:09Z")

</div>

Hey, @elisa.zoom, any update?

---

<div class="post-metadata">

**Author:** ![elisa.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/elisa.zoom/32/47836_2.png) [@elisa.zoom](https://devforum.zoom.us/u/elisa.zoom)\
**Post date:** [July 24, 2024, 4:57pm UTC](https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270/7 "2024-07-24T16:57:55Z")

</div>

Hi @joe.smithinc12123  
Sorry I missed this, make sure to ping me so I can get a notification 🙏  
I totally see what you are saying, I have an internal ticket ( ZOOM-774120) about this issue and will come back with an update as soon as I have it

Cheers,  
Elisa

---

<div class="post-metadata">

**Author:** ![joe.smithinc12123](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/joe.smithinc12123/32/60760_2.png) [@joe.smithinc12123](https://devforum.zoom.us/u/joe.smithinc12123)\
**Post date:** [August 13, 2024, 10:04am UTC](https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270/8 "2024-08-13T10:04:33Z")

</div>

Hey @elisa.zoom, hope you are well.

Any updates about the internal ticket?  
Went over my finding again and from what i saw, there is a miss-match in the names from zoom chat api docs and in the setup of the applications. For example  
in the docs: `chat_message:write` but in the app scope selection(the only one that is close): `team_chat:write:chat_message`. I think it might be a good idea to create another ticket the addresses the issue in the documentation.

Thanks for all your help.

---

<div class="post-metadata">

**Author:** ![elisa.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/elisa.zoom/32/47836_2.png) [@elisa.zoom](https://devforum.zoom.us/u/elisa.zoom)\
**Post date:** [August 13, 2024, 2:02pm UTC](https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270/9 "2024-08-13T14:02:06Z")

</div>

hi @joe.smithinc12123  
I do not have any updates on the ticket I created for this. I will re-engage with our Engineering team.

> For example  
> in the docs: `chat_message:write` but in the app scope selection(the only one that is close): `team_chat:write:chat_message` . I think it might be a good idea to create another ticket the addresses the issue in the documentation.

What endpoint are you talking about? For the Get a channel endpoint, I only see the team\_chat:read:channel listed in our Docs and I can see the scope in the server to server oauth app

 ![Screenshot 2024-08-13 at 10.01.43 AM](https://us1.discourse-cdn.com/flex016/uploads/zoomdeveloper/original/3X/5/a/5aa8d0af33d06726c183d2db7124f7aa6ff66373.png)

---

<div class="post-metadata">

**Author:** ![joe.smithinc12123](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/joe.smithinc12123/32/60760_2.png) [@joe.smithinc12123](https://devforum.zoom.us/u/joe.smithinc12123)\
**Post date:** [September 18, 2024, 12:42pm UTC](https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270/10 "2024-09-18T12:42:51Z")

</div>

Hey @elisa.zoom,  
Are there any updates about the internal ticket?  
I wanted to show a more concrete example of what i am talking about. For example in the endpoint for [updating channels](https://developers.zoom.us/docs/api/rest/reference/chat/methods/#operation/updateUserLevelChannel), the scope requested is `team_chat:update:channel`.

 ![image](https://us1.discourse-cdn.com/flex016/uploads/zoomdeveloper/original/3X/9/e/9e704fed6a58623bef8d15188dbab86e14926080.jpeg)  
When trying to add that scope, there is no scope with a name near to the one asked for. Even when adding all logicaly close scopes is still get the following message.

```json
{
  "code": 4711,
  "message": "Invalid access token, does not contain scopes [team_chat:update:channel]."
}

```

 ![image](https://us1.discourse-cdn.com/flex016/uploads/zoomdeveloper/original/3X/7/7/776d0df822f91dc562671d6d4e1e26718aef56a8.png)

Thanks.

---

<div class="post-metadata">

**Author:** ![joe.smithinc12123](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/joe.smithinc12123/32/60760_2.png) [@joe.smithinc12123](https://devforum.zoom.us/u/joe.smithinc12123)\
**Post date:** [October 9, 2024, 6:48am UTC](https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270/11 "2024-10-09T06:48:19Z")

</div>

@elisa.zoom any updates?  
thanks.

---

<div class="post-metadata">

**Author:** ![elisa.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/elisa.zoom/32/47836_2.png) [@elisa.zoom](https://devforum.zoom.us/u/elisa.zoom)\
**Post date:** [October 10, 2024, 4:41pm UTC](https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270/12 "2024-10-10T16:41:27Z")

</div>

> [@elisa.zoom](#):
>
> ZOOM-774120

Hi @joe.smithinc12123  
Sorry for not replying sooner but I have not heard back from the team. I just re-engaged with them and will keep you updated

---

<div class="post-metadata">

**Author:** ![joe.smithinc12123](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/joe.smithinc12123/32/60760_2.png) [@joe.smithinc12123](https://devforum.zoom.us/u/joe.smithinc12123)\
**Post date:** [November 3, 2024, 6:37am UTC](https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270/13 "2024-11-03T06:37:33Z")

</div>

Hey @elisa.zoom, any updates?

---

<div class="post-metadata">

**Author:** ![elisa.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/elisa.zoom/32/47836_2.png) [@elisa.zoom](https://devforum.zoom.us/u/elisa.zoom)\
**Post date:** [November 4, 2024, 3:50pm UTC](https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270/14 "2024-11-04T15:50:48Z")

</div>

> [@elisa.zoom](#):
>
> ZOOM-774120

Hi @joe.smithinc12123  
I have not heard back from my team but I just checked one of my sample apps and I can see the scope team\_chat:read:channel:admin …  
could you please check on your end if you are able to see it

---

<div class="post-metadata">

**Author:** ![joe.smithinc12123](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/joe.smithinc12123/32/60760_2.png) [@joe.smithinc12123](https://devforum.zoom.us/u/joe.smithinc12123)\
**Post date:** [November 6, 2024, 1:12pm UTC](https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270/15 "2024-11-06T13:12:26Z")

</div>

will check soon and update you, thanks!

---

<div class="post-metadata">

**Author:** ![joe.smithinc12123](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/joe.smithinc12123/32/60760_2.png) [@joe.smithinc12123](https://devforum.zoom.us/u/joe.smithinc12123)\
**Post date:** [November 10, 2024, 9:34am UTC](https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270/16 "2024-11-10T09:34:32Z")

</div>

Hey @elisa.zoom, tested it on my end, using an application with the `team_chat:delete:channels:admin` and running the `Delete Channel` endpoint, i still get the following error:

```json
      {
        "code": 4711,
        "message": "Invalid access token, does not contain scopes:[team_chat:delete:channel]."
      }

```

And there is no `team_chat:delete:channel` permission available to me to add to my application.

 ![image](https://us1.discourse-cdn.com/flex016/uploads/zoomdeveloper/original/3X/c/3/c397c5723e169041e61820655d17081ebadddbc3.png)  
Let me know if i can provide any information to aid the development team.  
Thanks.

---

<div class="post-metadata">

**Author:** ![jake\_siney](https://avatars.discourse-cdn.com/v4/letter/j/5daacb/32.png) [@jake\_siney](https://devforum.zoom.us/u/jake_siney)\
**Post date:** [November 12, 2024, 9:30am UTC](https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270/17 "2024-11-12T09:30:43Z")

</div>

I had this same issue, although with a different endpoint. My fix was changing the oauth token grant type from client\_credentials to account\_credentials and include account\_id from the application creds.

[https://developers.zoom.us/docs/internal-apps/s2s-oauth/#generate-access-token](https://developers.zoom.us/docs/internal-apps/s2s-oauth/#generate-access-token)

---

<div class="post-metadata">

**Author:** ![elisa.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/elisa.zoom/32/47836_2.png) [@elisa.zoom](https://devforum.zoom.us/u/elisa.zoom)\
**Post date:** [November 12, 2024, 2:58pm UTC](https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270/18 "2024-11-12T14:58:21Z")

</div>

@jake_siney thanks for chiming in! if you are using a Server to Server app type, then yes! this is what needs to be done… the grant type for S2S app is account\_credentials vs the General app type that users client\_credentials.

@joe.smithinc12123 can you confirm your request is correct? let me know and if everything is set up correctly on your end, I am happy to look further into this issue

---

<div class="post-metadata">

**Author:** ![joe.smithinc12123](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/joe.smithinc12123/32/60760_2.png) [@joe.smithinc12123](https://devforum.zoom.us/u/joe.smithinc12123)\
**Post date:** [December 24, 2024, 9:26am UTC](https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270/19 "2024-12-24T09:26:17Z")

</div>

hey Elisa,  
I double checked with Zoom’s documentation and my own backend code to see that the request i send are valid. Also checked and compared to what I get by using Postman and everything seems good.

Also seeing that other zoom endpoints in the Chat API do seem to work, and when endpoints don’t work they give me an error about scopes I think this is a limitation on zoom’s side. The scopes that are requested in the endpoints i mentioned above don’t exist in the application selection.

Thanks you.

---

<div class="post-metadata">

**Author:** ![joe.smithinc12123](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/joe.smithinc12123/32/60760_2.png) [@joe.smithinc12123](https://devforum.zoom.us/u/joe.smithinc12123)\
**Post date:** [January 5, 2025, 8:19am UTC](https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270/20 "2025-01-05T08:19:44Z")

</div>

@elisa.zoom forgot to tag 😉

[Next page](https://devforum.zoom.us/t/missing-granular-scopes-in-scope-selection-for-chat-api/112270.md?page=2)