Introduction
Using Zoom APIs
Pagination
Error Definitions
Rate Limits
Testing Zoom APIs
Accounts
Billing
Chat Channels
Chatbot Messages
Contacts
Cloud Recording
Dashboards
Devices
Groups
IM Chat
IM Groups
Meetings
PAC
Phone
Phone Auto Receptionists
Phone Blocked List
Phone Call Queues
Phone Devices
Phone Shared Line Groups
Phone Site
Common Area Phones
Reports
Roles
Rooms
Rooms Account
Rooms Location
SIP Phone
TrackingField
TSP
Users
Webinars
SIP Connected Audio
Account Events
App Events
Chat Message Events
Chat Channel Events
Chatbot Events
Meeting Events
Recording Events
User Events
Webinar Events
Zoom Room Events
Data Compliance
get

/chat/users/{userId}/messages

A Zoom user can have conversations with other Zoom users via chat. Use this API to list the current user’s chat messages between the user and an individual contact or a chat channel.
In the query parameter, you must provide either of the following:

  • to_contact: The email address of the contact with whom the user conversed by sending/receiving messages.
  • to_channel: The channel ID of the channel to/from which the user has sent and/or received messages.
    Specify a date in the date query parameter to view messages from that date. If a date is not provided, the default value for the query will be the current date.

Note: This API only supports user-managed OAuth app.



Scopes: chat_message:read

Rate Limit Label: Medium

Authorization

oauth2 - authorizationCode

Request Parameters

1 Path Parameter
5 Query Parameters

Responses

HTTP Status Code:200
List of chat messages returned.

1 Example
Schema
object

Chat message object.

date
string

The date provided in the query parameter. If a date is not provided, the default value is the current date.

1 validation
page_size
integer

The number of records returned with a single API call.

1 validation
next_page_token
string

The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.

messages
array[object]

List of message(s).

Send a Test Request

Send requests directly from the browser (CORS must be enabled)
Path Params
1 path param not set
userId
$$.env
1 variable not set
oauth_access_token