Zoho Cliq
Zoho Cliq connector for managing channels, users, teams, chats, and messages.
Categories: Communication, Team Chat, Collaboration
What you can ask
- Post the daily standup summary to the
#engineeringchannel - List the messages in the
Support Escalationschat from today - Create a channel for the
Q3 Launchproject and add the team
Set up
Zoho Cliq needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.
- Go to Organization > Connectors and find Zoho Cliq. Click Enable, and choose which tools to allow.
- Create an OAuth application in the Zoho Cliq developer portal.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- Each member connects their own account the first time they use it.
⚠️ Warning: Do not enter your Devs.ai or Zoho Cliq login email or password in the OAuth application fields.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
OAuth scopes used by these tools (59)
Grant the scopes for the tools you plan to allow.
ZohoCliq.Applications.UPDATEZohoCliq.Attachments.READZohoCliq.Bots.READZohoCliq.CalendarEvents.ALLZohoCliq.Channels.CREATEZohoCliq.Channels.DELETEZohoCliq.Channels.READZohoCliq.Channels.UPDATEZohoCliq.Chats.CREATEZohoCliq.Chats.DELETEZohoCliq.Chats.READZohoCliq.Chats.UPDATEZohoCliq.Departments.CREATEZohoCliq.Departments.DELETEZohoCliq.Departments.READZohoCliq.Departments.UPDATEZohoCliq.Designations.CREATEZohoCliq.Designations.DELETEZohoCliq.Designations.READZohoCliq.Designations.UPDATEZohoCliq.MediaSession.READZohoCliq.Messages.DELETEZohoCliq.Messages.READZohoCliq.Messages.UPDATEZohoCliq.Organisation.CREATEZohoCliq.Organisation.DELETEZohoCliq.Organisation.READZohoCliq.Organisation.UPDATEZohoCliq.OrganizationChannels.READZohoCliq.OrganizationChats.READZohoCliq.OrganizationMessages.READZohoCliq.Profile.CREATEZohoCliq.Profile.DELETEZohoCliq.Profile.READZohoCliq.Profile.UPDATEZohoCliq.Reminders.CREATEZohoCliq.Reminders.DELETEZohoCliq.Reminders.READZohoCliq.Reminders.UPDATEZohoCliq.Storage.READZohoCliq.StorageData.CREATEZohoCliq.StorageData.DELETEZohoCliq.StorageData.READZohoCliq.StorageData.UPDATEZohoCliq.Teams.CREATEZohoCliq.Teams.DELETEZohoCliq.Teams.READZohoCliq.Teams.UPDATEZohoCliq.UserFields.CREATEZohoCliq.Userfields.DELETEZohoCliq.Userfields.UPDATEZohoCliq.Users.CREATEZohoCliq.Users.READZohoCliq.Users.UPDATEZohoCliq.Webhooks.CREATEZohoCliq.messageactions.CREATEZohoCliq.messageactions.DELETEZohoCliq.messageactions.READZohoCliq.messages.CREATE
Tools
Zoho Cliq offers 152 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (55)
View and search information without changing it.
| Tool | What it does |
|---|---|
bulk_export_channels | Export org channels as CSV (admin only; fields default to all channel columns). |
bulk_export_chat_members | Export chat members as CSV (admin only; use list_chats or list_channels for chat IDs; default fields: name, email, user_id). |
bulk_export_chat_messages | Export a chat transcript as JSON (admin only; use list_chats or list_channels for chat IDs). |
bulk_export_conversations | Export org chats as CSV (admin only; default fields: title, chat_id). |
get_channel | Get a single channel by ID. |
get_current_status | Get the authenticated user's current active status (code, message, and id). |
get_custom_domain | Get the organization's custom domain and its verification status. |
get_database_record | Get one record from a Cliq database by its ID. |
get_department | Get a single department by ID, including its lead and member count. |
get_designation | Get a single designation by ID. |
get_event | Get the details of a specific event, including its edit_tag (needed by delete_event) and attendees. |
get_file | Retrieve a file from a chat, channel, or bot by its file ID. |
get_mail_configuration | Get the organization's global mail configuration (sender name, email address, and CNAME status). |
get_message | Retrieve a single message from a chat by its ID. |
get_reminder | Get a single reminder by its ID, including its content, fire time, assignees, and any anchored chats. |
get_remote_work_status | Get the authenticated user's remote-work check-in status (whether checked in, since when, and session duration). |
get_role | Get a single role by ID, including its type and description. |
get_team | Get a single team by ID. |
get_thread_main_message | Get the main (parent) message a thread was created from, including its sender, content, and thread information. |
get_user | Get a single user by ID. |
get_user_field | Get a single user field by ID, including its type and options. |
get_user_status | Get another user's current presence (state, activity, and status text) by user ID. |
list_bot_subscribers | List the users subscribed to a bot, by the bot's unique name (no API lists bots, so ask the user for it). |
list_calendars | List all calendars associated with the authenticated user, including each calendar's uid to pass as calendar_id to create_event, get_event, delete_event, and list_events. |
list_call_participants | List the participants of a specific call or meeting, with an optional live/invited/joined filter and cursor pagination. |
list_calls_and_meetings | List the authenticated user's call history — direct calls, meetings, and broadcasts — with optional type, category filter, title search, time window, host/recipient filters, and cursor pagination. |
list_channel_members | List all members of a channel. |
list_channel_threads | List the threads (threaded side-conversations) in a channel, with cursor pagination. |
list_channels | List channels with optional server-side filters (name contains, status, level) and cursor pagination. |
list_chat_members | List all members participating in a group chat or channel. |
list_chats | List the current user's chats (conversations). |
list_database_records | List records in a Cliq database, by its unique name (use list_databases). |
list_databases | List the Cliq databases the user can access, with each database's unique name and fields. |
list_department_members | List the members of a department. |
list_departments | List the organization's departments, with an optional name search and cursor pagination. |
list_designation_members | List the members associated with a designation, with cursor pagination. |
list_designations | List up to limit designations (max 100); this endpoint has no further pages. |
list_events | List the authenticated user's events scheduled within the next 31 days, with optional time-window (from_time/to_time), title search, and hidden/disabled calendar filters. |
list_messages | List messages in a chat with optional server-side time filters (fromtime, totime) and time-based pagination. |
list_pinned_messages | List the pinned (sticky) messages in a chat, most recently pinned first. |
list_reactions | List all reactions on a message, grouped by emoji with the users who added each. |
list_reminders | List reminders for the authenticated user, with cursor pagination. |
list_role_permissions | List all permissions assigned to a role, as a per-module mapping. |
list_role_users | List the users assigned to a role. |
list_roles | List the organization's roles (admin profiles). |
list_statuses | List all custom statuses saved by the authenticated user. |
list_team_members | List all members of a team. |
list_teams | List teams in the organization, optionally limited to teams the user has joined (joined=true). |
list_thread_followers | List the users following a thread (returns the full set, no pagination). |
list_thread_non_followers | List the channel members who are NOT following a thread (returns the full set, no pagination). |
list_user_field_layouts | List the layout configurations for user fields. |
list_user_fields | List all custom and system user fields in the organization. |
list_user_teams | List all teams a specific user belongs to. |
list_users | List organization users with optional server-side filters (search by name/email, status) and cursor pagination. |
validate_credential | Validate the Zoho Cliq OAuth credential by listing channels. |
Write (39)
Create or send data.
| Tool | What it does |
|---|---|
add_bot_to_channel | Add a bot to a channel, by the bot's unique name (ask the user) and the channel's unique name (use list_channels). |
add_channel_members | Add members to a channel by user ID or email. |
add_custom_domain | Add a custom domain to the organization. |
add_department_members | Add members to a department. |
add_designation_members | Add members to a designation. |
add_reaction | Add an emoji reaction to a message in a chat. |
add_role_users | Add users to a role. |
add_team_members | Add members to a team. |
add_thread_followers | Add one or more users as followers of a thread, so they receive reply notifications. |
assign_reminder_users | Assign up to 4 users to a reminder, so they are notified when it fires. |
create_channel | Create a new channel. |
create_database_record | Add a record to a Cliq database. |
create_department | Create a department with a name, lead_zuid and at least one initial member in user_ids. |
create_designation | Create a designation (job title). |
create_event | Create a calendar event. |
create_reminder | Create a reminder for yourself, teammates, a chat, or a specific message. |
create_role | Create a custom role. |
create_scheduled_message | Schedule a message for future delivery in a chat, either at a fixed time (schedule_time, ISO8601 basic yyyyMMddTHHmmss) or when the recipient's status changes (schedule_status). |
create_status | Create a new saved custom status (presence code plus a message) for the authenticated user. |
create_team | Create a new team in the organization. |
create_user | Invite a new organization user by email. |
create_user_field | Create a custom user field. |
follow_thread | Follow a thread as the authenticated user to receive notifications for new replies. |
join_channel | Join a channel as the authenticated user. |
pin_message | Pin a message in a chat for a given duration. |
remind_assignee | Send an immediate reminder notification to one specific assignee, bypassing the scheduled time. |
remind_assignees | Send an immediate reminder notification to all pending assignees at once, bypassing the scheduled time. |
remote_check_in | Check the authenticated user in as working remotely. |
send_bot_message | Send a message as a bot to its subscribers, by the bot's unique name (ask the user for it). |
send_channel_message | Post a message to a channel, notifying its members. |
send_chat_message | Post a message to a chat, notifying its participants. |
send_message_to_channel | Post a message to a channel by its unique name (not its ID). |
send_message_to_user | Send a direct message to a user by their email address. |
share_file_to_bot | Share a file to a bot, by the bot's unique name (ask the user for it). |
share_file_to_channel | Share a file to a channel by its unique name. |
share_file_to_chat | Share a file to a chat by its chat ID. |
share_file_to_user | Share a file with a user by their email address. |
trigger_bot_call | Place a voice alert from a bot to specific users: Cliq calls each user and reads text aloud, with optional retries and buttons. |
upload_event_attachment | Upload a file to your calendar so it can be attached to events. |
Delete or overwrite (58)
Remove or replace existing data.
| Tool | What it does |
|---|---|
add_transient_status | Set a temporary (transient) status that automatically expires at a given time. |
approve_channel | Approve a newly created organization-level channel that is awaiting approval (status 'pending'). |
archive_channel | Archive a channel to stop new messages. |
bulk_delete_reminders | Delete multiple reminders by their IDs in one call (maximum 20). |
delete_channel | Delete a channel permanently by ID. |
delete_completed_reminders | Delete all reminders that are marked complete, in one call. |
delete_custom_domain | Delete the organization's custom domain. |
delete_database_record | Delete a record from a Cliq database permanently. |
delete_department | Delete a department by ID. |
delete_designation | Delete a designation by ID. |
delete_event | Delete a calendar event. |
delete_message | Delete a message from a chat permanently. |
delete_reaction | Remove an emoji reaction from a message. |
delete_reminder | Delete a reminder by its ID. |
delete_role | Delete a role by ID. |
delete_status | Delete a saved custom status by its ID. |
delete_team | Delete a team from the organization by ID. |
delete_transient_status | Clear the authenticated user's current transient status before it expires. |
delete_user_field | Delete a custom user field by ID. |
dismiss_snoozed_reminder | Dismiss the snooze on a snoozed reminder, so it reverts to its original fire time. |
leave_channel | Leave a channel as the authenticated user. |
leave_group_chat | Remove the authenticated user from a group chat or channel. |
mark_reminder_complete | Mark a reminder as complete by its ID. |
mark_reminder_incomplete | Mark a reminder as incomplete (reopen it) by its ID. |
mute_chat | Mute notifications for a chat while keeping the user an active participant. |
reject_channel | Reject a newly created organization-level channel that is awaiting approval (status 'pending'). |
remote_check_out | Check the authenticated user out from remote work. |
remove_channel_members | Remove one or more members from a channel by user ID or email. |
remove_department_members | Remove members from a department. |
remove_designation_members | Remove members from a designation. |
remove_role_users | Remove users from a role. |
remove_team_member | Remove a member from a team by user ID. |
remove_thread_followers | Remove one or more users from a thread's followers, so they stop receiving reply notifications. |
snooze_reminder | Snooze a reminder to delay its notification by a duration (in milliseconds). |
unarchive_channel | Unarchive a channel to resume messaging. |
unassign_reminder_user | Unassign a user from a reminder, so they stop being notified. |
unfollow_thread | Stop following a thread as the authenticated user, to stop receiving reply notifications (also used to leave a thread conversation). |
unmute_chat | Restore notifications for a previously muted chat. |
unpin_message | Remove the pinned (sticky) message from a chat. |
update_channel | Update a channel's name, description, and/or thread auto-follow setting by ID. |
update_channel_member_role | Change a member's role in a channel. |
update_current_status | Set a saved status as the authenticated user's current active status, by status ID. |
update_database_record | Update fields of a record in a Cliq database. |
update_department | Update a department's details. |
update_designation | Update a designation's title. |
update_event | Update a calendar event. |
update_event_status | Update your RSVP status for an event: accepted, tentative, declined, or yet_to_respond. |
update_mail_configuration | Update the organization's global mail configuration. |
update_message | Edit the text of an existing message in a chat. |
update_reminder | Update a reminder's content and/or fire time. |
update_role | Update a role's name and description. |
update_role_permissions | Update a role's permissions. |
update_team | Update a team's name and/or description by ID. |
update_thread_state | Set a thread's state to 'closed' (stop new replies) or 'open' (reopen it). |
update_user | Update a user's profile fields by ID. |
update_user_field | Update a user field's name, flags (mandatory, encrypted, edit_permission) or options. |
upsert_map_ticker | Add or update tickers (live markers) on a widget's map view. |
verify_custom_domain | Verify ownership of the organization's custom domain by setting its status to 'active'. |