Chats

A chat is the conversation container — a DM or group — and every message is sent inside one. This guide covers the chat-lifecycle endpoints. For creating chats and managing group-specific properties (display name, icon, participants, leaving a group), see Group Chats. For message-level operations see Sending Messages.

Chats are created by sending the first message. See Starting a conversation in the Sending Messages guide for the full example, or the Create Chat API reference.

List every chat the authenticated partner has access to, optionally filtered by sender number (from) or participant (to). Results are paginated — pass the previous response’s next_cursor back as cursor until it returns null. Default page size is 20, max is 100. See the List Chats API reference.

Fetch a single chat by ID. The response includes participants, conversation protocol, chat health, and more. See the Retrieve Chat API reference for full details.

Mark every message in a chat as read, which sends a read receipt on iMessage/RCS. See the Mark As Read API reference.

Note: Calling mark-as-read on a group chat has no effect. Read receipts only exist in one-to-one iMessage and RCS conversations.

• Group Chats — creating chats, managing participants, group name / icon, leaving a group
• Typing Indicators — typing state inside a chat
• Chat Health — how we score chat health and what it means for your line
• Sending Messages — posting messages to a chat
• API Reference: Chats