Zoom Team Chat

Add members to a Zoom Team Chat shared space by email address or Zoom user ID. Zoom processes each member independently and returns HTTP 200/201 even when every add fails, so success must be judged from successful_operations_count / unsuccessful_operations_count and each entry's operation_status - not the HTTP status.

Archive or unarchive up to 10 Zoom Team Chat channels in one call. Returns per-channel failures; success requires failed_channels to be empty.

Add or remove a bookmark on a Zoom Team Chat message. Identify the message by message_id plus the conversation it lives in: provide exactly one of to_channel (a channel message) or to_contact (a 1:1 message). Set action to 'add_bookmark' (default) or 'remove_bookmark'. Returns {success: true} on success; the underlying API responds with HTTP 204 and an empty body.

Create a new Zoom Team Chat channel for the authenticated user, optionally inviting initial members by email.

Set a reminder on a Zoom Team Chat message, either after a delay (delay_seconds) or at an absolute time (remind_time). Exactly one of to_channel or to_contact must identify where the message lives, and exactly one of delay_seconds or remind_time must set the timing.

Create a Zoom Team Chat shared space (a container that groups related channels). A 'general' channel is auto-created with it.

Delete a Zoom Team Chat channel the user owns or is a member of. Returns {success: true} on success; the underlying API responds with HTTP 204 and an empty body.

Delete a Zoom Team Chat message the connected user sent, identified by message_id plus the conversation it lives in. Provide exactly one of to_channel (a channel message) or to_contact (a 1:1 message). Returns {success: true} on success; the underlying API responds with HTTP 204 and an empty body.

Delete the reminder set on a Zoom Team Chat message. Reminders have no id of their own — they are identified by the message_id they belong to. Provide exactly one of to_channel (a channel message) or to_contact (a 1:1 message) to locate the message. Returns {success: true} on success; the API responds with HTTP 204 and an empty body.

Delete a scheduled (draft) Zoom Team Chat message before it is sent, identified by draft_id plus the conversation it is addressed to. Provide exactly one of to_channel (a channel draft) or to_contact (a 1:1 draft). Returns {success: true} on success; the underlying API responds with HTTP 204 and an empty body.

Delete a Zoom Team Chat shared space. Returns {success: true} on success; the underlying API responds with HTTP 204 and an empty body. NOTE: the space's auto-created 'general' channel SURVIVES as a regular channel and must be deleted separately with DELETE_CHANNEL.

Get full information about a Zoom Team Chat channel, including its settings.

Get a single Zoom Team Chat contact by email or user ID, optionally with live presence status.

Get a single Zoom Team Chat message by ID, including its deep-link URL.

Retrieve a Zoom Team Chat message's thread: the parent message plus its replies since a given time.

Get details of a Zoom Team Chat shared space, including its owner and settings.

Invite members to a Zoom Team Chat channel by email address. Returns only an invitation timestamp - Zoom does not echo per-member results, and external invitees stay invisible in the member list until they accept.

Join a public Zoom Team Chat channel as the authenticated user. Only public (type 3 or 5) channels can be joined this way; private and invite-only channels require an invitation.

Leave a Zoom Team Chat channel. WARNING: if the channel OWNER leaves an invite-only channel they cannot rejoin or delete it afterwards — the channel is orphaned. Owners should delete the channel instead. Returns {success: true} on success; the underlying API responds with HTTP 204 and an empty body.

List the authenticated user's bookmarked Zoom Team Chat messages, optionally filtered to one channel (to_channel) or one 1:1 contact (to_contact). Omit both filters to list bookmarks across all conversations.

List the members of a Zoom Team Chat channel.

List the Zoom Team Chat channels the authenticated user is a member of.

List the authenticated user's Zoom Team Chat contacts. Zoom returns company contacts by default; pass type='external' for external contacts. The user themself appears as a contact, and each contact's id can be used as a to_contact value for 1:1 messaging.

List Zoom Team Chat messages exchanged in a channel or a 1:1 conversation, newest first (defaults to today). Provide exactly one of to_channel or to_contact.

List the pinned messages of a Zoom Team Chat channel. Set include_history to also return previously-pinned (now unpinned) history messages.

List the authenticated user's Zoom Team Chat message reminders. Optionally filter by a channel (to_channel) or a 1:1 contact (to_contact); omit both to list all reminders.

List the user's scheduled (draft) Zoom Team Chat messages queued to send to a channel or a 1:1 contact. Provide exactly one of to_channel or to_contact.

List the user's recent Zoom Team Chat sessions (channels and 1:1 conversations) within a time window. Defaults to today; groupchat sessions are channels and 1:1 sessions carry peer contact info.

List the channels grouped inside a Zoom Team Chat shared space.

List the members and administrators of a Zoom Team Chat shared space.

List the Zoom Team Chat shared spaces the authenticated user belongs to.

Mark a Zoom Team Chat message as read or unread. Identify the message by message_id plus the conversation it lives in: provide exactly one of to_channel (a channel message) or to_contact (a 1:1 message). Set action to 'read' (default) or 'unread'. Returns {success: true} on success; the underlying API responds with HTTP 204 and an empty body.

Move existing Zoom Team Chat channels into or out of a shared space. Returns per-channel results; success requires every channel to report is_moved=true.

Pin or unpin a message in a Zoom Team Chat channel. Set action to 'pin' or 'unpin', and identify the message by message_id plus the channel_id it belongs to. Returns {success: true} on success; the underlying API responds with HTTP 204 and an empty body.

Add or remove an emoji reaction on a Zoom Team Chat message. Identify the message by message_id plus the conversation it lives in: provide exactly one of to_channel (a channel message) or to_contact (a 1:1 message). The emoji is a Unicode codepoint string without a 'U+' prefix (e.g. '1F44D'). Returns {success: true} on success; the underlying API responds with HTTP 204 and an empty body.

Remove a single member from a Zoom Team Chat channel. Returns {success: true} on success; the underlying API responds with HTTP 204 and an empty body. Removing someone who is not a member of the channel fails with a 404 (code 1001).

Remove members or administrators from a Zoom Team Chat shared space by user ID or member ID (the shared space owner cannot be removed). Zoom processes each identifier independently and returns HTTP 200 even when every removal fails, so success must be judged from successful_operations_count / unsuccessful_operations_count and each entry's operation_status - not the HTTP status.

Search Zoom Team Chat channels by name — fuzzy keywords or an exact channel name — across the channels the user has joined or the org's public channels. Returns one page of matches (max 20) plus a next_page_token cursor.

Search the connected user's organization directory for contacts by keyword (first name, last name, or email address). Optionally include each contact's presence status.

Send a Zoom Team Chat message to a channel or a 1:1 contact, optionally as a thread reply (reply_main_message_id) or scheduled for later (scheduled_time). Exactly one of to_channel or to_contact must be provided.

Star or unstar a Zoom Team Chat channel or contact for the authenticated user. Set target_type to 'channel' or 'contact' and target_id to the channel ID, contact user ID, or contact member ID. Returns {success: true} on success; the underlying API responds with HTTP 204 and an empty body.

Rename a Zoom Team Chat channel or update its type/settings.

Edit the text of an existing Zoom Team Chat message.

Update a Zoom Team Chat shared space's name, description, or settings.