Unable to get imchat:bot scope — getting error 7010 when calling /v2/im/chat/messages

Hi everyone,

I followed the documentation at Get credentials - Chat - Zoom Developer Docs to create a Chatbot app and enabled Team Chat Subscription. The app is working — I can receive
webhook events (bot_notification) successfully.

However, when I try to send a message by calling POST /v2/im/chat/messages, I get the following response:

{
“code”: 7010,
“message”: “Invalid authorization token.”,
“result”: false
}

I’m using a Client Credentials OAuth token obtained from POST /oauth/token?grant_type=client_credentials. The token is valid, but the scope field in the response does not
include imchat:bot

I checked the Scopes section in my app configuration and I cannot find imchat:bot anywhere to add it manually. The documentation mentions:

▎ “The following scope is automatically selected once you create a Chat Command: imchat:bot (required)”

I tried adding a Chat Command in the Features section, but imchat:bot still does not appear in the Scopes.

My questions:

  1. Is the missing imchat:bot scope the reason for the 7010 error?
  2. How can I get imchat:bot added to my app? Is there a specific configuration step I’m missing?

Any help would be appreciated. Thanks!

@WayneYang ,

You will need to create a General App with Admin Level Oauth.

”Chat” should be enabled in the Surface Tab, and you should also turn on “Team Chat Subscription”

You should be able to add the imchat:bot scope

Hi Chun Siong,

Thank you so much for your help! The issue has been resolved.

The core reason it wasn’t working before was that I hadn’t selected the “Admin Level OAuth” option. Once I adjusted that, everything started working perfectly.