GET {{baseUrl}}/chat/users/:userId/messages?to_contact=<email>&to_channel=<string>&date=<date>&from=<dateTime>&to=<dateTime>&page_size=10&next_page_token=<string>&include_deleted_and_edited_message=<boolean>&search_type=file&search_key=<string>&exclude_child_message=false&download_file_formats=audio/mp4
Searches chat messages or shared files between a user and an individual contact or a chat channel. For user-level apps, pass the Note: For an account-level OAuth app, this API can only be used on behalf of a user who is assigned with a role that has the View or Edit permission for Chat Messages.me
value instead of the userId
parameter.
Scopes: chat_message:read
, chat_message:read:admin
Rate Limit Label: Medium
Body
PARAM
Key | Datatype | Required | Description |
to_contact
|
string | This field allows you to query by the email address or user ID or member ID of a chat contact with whom the user communicated. The API only returns messages sent and/or received between the user and the queried contact. **Note:** * You must provide either the `to_contact` or the `to_channel` query parameter. * When you call the `search_key` and `search_type` query parameters, this query parameter is optional and **not** required. | |
to_channel
|
string | This field queries by the channel ID of a channel in which the user had chat conversations. The API only returns messages sent and/or received by the user in the queried channel. **Note:** * You must provide either the `to_contact` or the `to_channel` query parameter. * When you call the `search_key` and `search_type` query parameters, this query parameter is optional and **not** required. | |
date
|
string | The query date from which to retrieve the chat messages. This value defaults to the current date. **Note:** If you do not provide the `date` or `from` query parameters, the API defaults to the `date` query parameter. | |
from
|
string | The query start date, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format. **Note:** If you provide both the `date` and `from` query parameters, the API queries using the `date` value. | |
to
|
string | The query end date, in `yyyy-MM-dd'T'HH:mm:ss'Z'` format. This value defaults to the current date. | |
page_size
|
Curl curl -X GET 'https://api.zoom.us/v2/chat/users/:userId/messages?to_contact=<email>&to_channel=<string>&date=<date>&from=<dateTime>&to=<dateTime>&page_size=10&next_page_token=<string>&include_deleted_and_edited_message=<boolean>&search_type=file&search_key=<string>&exclude_child_message=false&download_file_formats=audio/mp4?to_contact=<email>&to_channel=<string>&date=<date>&from=<dateTime>&to=<dateTime>&page_size=10&next_page_token=<string>&include_deleted_and_edited_message=<boolean>&search_type=file&search_key=<string>&exclude_child_message=false&download_file_formats=audio/mp4' -H 'Accept: application/json' ENDPOINTS |