v1

latestOpenAPI 3.0.3RingCentral API License Agreement2026-08-064871,2921.5 MB
Chats

List Chats

Returns the list of chats where the user is a member and also public teams that can be joined.

All records in response are sorted by creation time of a chat in ascending order.

Chat types

There are multiple types of chats, including:

  • Personal - each user is given a dedicated "personal chat" in which they are the only member.
  • Direct - a chat between two individuals.
  • Group - a chat between three or more named individuals. A "group" chat has no name.
  • Team - a chat related to a specific topic. Members can come and go freely from this chat type.
  • Everyone - a special chat containing every individual in a company.
get/team-messaging/v1/chats

Query parameters

typestring[]

Type of chats to be fetched. By default, all type of chats will be fetched

recordCountinteger

Number of chats to be fetched by one request. The maximum value is 250, by default - 30.

pageTokenstring

Pagination token.

Response

OK