Zoho Cliq icon

Zoho Cliq

Fully manage your Zoho Cliq workspace: messages, channels, teams, users, databases, events, reminders, bots, files, and more

Actions168

Chat → Get Chat Members

AI-generated

Summary

Retrieves a list of members for a specified Zoho Cliq chat using the chat ID.

Inputs

  • Chat ID (required) — Required Zoho Cliq chat ID for the conversation whose members you want to retrieve. This is not a channel ID. Chat IDs may be all-numeric for direct or private conversations or use a CT_... style in some other chat contexts. Do not pass a channel_id, channel unique name, or display name.
  • Fields in Response — Optional member fields to include. Allowed values: name, email_id, user_id. When configuring this with AI input, use comma-separated values with no spaces, such as name,email_id. Bot members may not include email_id even when requested, and response entries for bots may also include fields such as bot_unique_name and store_app_id. A store_app_id of -1 means the bot is not a marketplace custom bot and app_key-based access is not needed. A real store_app_id value may mean some bot or message operations require that bot's app_key. This is AI-friendly and useful for limiting the response to only what the workflow needs, which helps preserve model context. Leave the defaults to return all supported fields.
  • Enable AI Error Mode — Whether to return errors as output items (continue-on-fail style) instead of stopping execution. Recommended for AI Tool runs that should recover from API errors.

Output shape

a list of items

Each item represents a chat member. The shape of the member object depends on the selected fields; bots may include bot_unique_name and store_app_id.

Examples

Example 1: Get all members for a direct chat using a numeric ID

Chat ID: 1234567890, Fields: name, email_id, user_id (defaults)

Example 2: Retrieve only user IDs and names for a private group chat

Chat ID: CT9876543210, Fields: name, user_id

Links

Discussion