Skip to main content

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 #engineering channel
  • List the messages in the Support Escalations chat from today
  • Create a channel for the Q3 Launch project 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.

  1. Go to Organization > Connectors and find Zoho Cliq. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the Zoho Cliq developer portal.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. 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.UPDATE
  • ZohoCliq.Attachments.READ
  • ZohoCliq.Bots.READ
  • ZohoCliq.CalendarEvents.ALL
  • ZohoCliq.Channels.CREATE
  • ZohoCliq.Channels.DELETE
  • ZohoCliq.Channels.READ
  • ZohoCliq.Channels.UPDATE
  • ZohoCliq.Chats.CREATE
  • ZohoCliq.Chats.DELETE
  • ZohoCliq.Chats.READ
  • ZohoCliq.Chats.UPDATE
  • ZohoCliq.Departments.CREATE
  • ZohoCliq.Departments.DELETE
  • ZohoCliq.Departments.READ
  • ZohoCliq.Departments.UPDATE
  • ZohoCliq.Designations.CREATE
  • ZohoCliq.Designations.DELETE
  • ZohoCliq.Designations.READ
  • ZohoCliq.Designations.UPDATE
  • ZohoCliq.MediaSession.READ
  • ZohoCliq.Messages.DELETE
  • ZohoCliq.Messages.READ
  • ZohoCliq.Messages.UPDATE
  • ZohoCliq.Organisation.CREATE
  • ZohoCliq.Organisation.DELETE
  • ZohoCliq.Organisation.READ
  • ZohoCliq.Organisation.UPDATE
  • ZohoCliq.OrganizationChannels.READ
  • ZohoCliq.OrganizationChats.READ
  • ZohoCliq.OrganizationMessages.READ
  • ZohoCliq.Profile.CREATE
  • ZohoCliq.Profile.DELETE
  • ZohoCliq.Profile.READ
  • ZohoCliq.Profile.UPDATE
  • ZohoCliq.Reminders.CREATE
  • ZohoCliq.Reminders.DELETE
  • ZohoCliq.Reminders.READ
  • ZohoCliq.Reminders.UPDATE
  • ZohoCliq.Storage.READ
  • ZohoCliq.StorageData.CREATE
  • ZohoCliq.StorageData.DELETE
  • ZohoCliq.StorageData.READ
  • ZohoCliq.StorageData.UPDATE
  • ZohoCliq.Teams.CREATE
  • ZohoCliq.Teams.DELETE
  • ZohoCliq.Teams.READ
  • ZohoCliq.Teams.UPDATE
  • ZohoCliq.UserFields.CREATE
  • ZohoCliq.Userfields.DELETE
  • ZohoCliq.Userfields.UPDATE
  • ZohoCliq.Users.CREATE
  • ZohoCliq.Users.READ
  • ZohoCliq.Users.UPDATE
  • ZohoCliq.Webhooks.CREATE
  • ZohoCliq.messageactions.CREATE
  • ZohoCliq.messageactions.DELETE
  • ZohoCliq.messageactions.READ
  • ZohoCliq.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.

ToolWhat it does
bulk_export_channelsExport org channels as CSV (admin only; fields default to all channel columns).
bulk_export_chat_membersExport chat members as CSV (admin only; use list_chats or list_channels for chat IDs; default fields: name, email, user_id).
bulk_export_chat_messagesExport a chat transcript as JSON (admin only; use list_chats or list_channels for chat IDs).
bulk_export_conversationsExport org chats as CSV (admin only; default fields: title, chat_id).
get_channelGet a single channel by ID.
get_current_statusGet the authenticated user's current active status (code, message, and id).
get_custom_domainGet the organization's custom domain and its verification status.
get_database_recordGet one record from a Cliq database by its ID.
get_departmentGet a single department by ID, including its lead and member count.
get_designationGet a single designation by ID.
get_eventGet the details of a specific event, including its edit_tag (needed by delete_event) and attendees.
get_fileRetrieve a file from a chat, channel, or bot by its file ID.
get_mail_configurationGet the organization's global mail configuration (sender name, email address, and CNAME status).
get_messageRetrieve a single message from a chat by its ID.
get_reminderGet a single reminder by its ID, including its content, fire time, assignees, and any anchored chats.
get_remote_work_statusGet the authenticated user's remote-work check-in status (whether checked in, since when, and session duration).
get_roleGet a single role by ID, including its type and description.
get_teamGet a single team by ID.
get_thread_main_messageGet the main (parent) message a thread was created from, including its sender, content, and thread information.
get_userGet a single user by ID.
get_user_fieldGet a single user field by ID, including its type and options.
get_user_statusGet another user's current presence (state, activity, and status text) by user ID.
list_bot_subscribersList the users subscribed to a bot, by the bot's unique name (no API lists bots, so ask the user for it).
list_calendarsList 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_participantsList the participants of a specific call or meeting, with an optional live/invited/joined filter and cursor pagination.
list_calls_and_meetingsList 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_membersList all members of a channel.
list_channel_threadsList the threads (threaded side-conversations) in a channel, with cursor pagination.
list_channelsList channels with optional server-side filters (name contains, status, level) and cursor pagination.
list_chat_membersList all members participating in a group chat or channel.
list_chatsList the current user's chats (conversations).
list_database_recordsList records in a Cliq database, by its unique name (use list_databases).
list_databasesList the Cliq databases the user can access, with each database's unique name and fields.
list_department_membersList the members of a department.
list_departmentsList the organization's departments, with an optional name search and cursor pagination.
list_designation_membersList the members associated with a designation, with cursor pagination.
list_designationsList up to limit designations (max 100); this endpoint has no further pages.
list_eventsList 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_messagesList messages in a chat with optional server-side time filters (fromtime, totime) and time-based pagination.
list_pinned_messagesList the pinned (sticky) messages in a chat, most recently pinned first.
list_reactionsList all reactions on a message, grouped by emoji with the users who added each.
list_remindersList reminders for the authenticated user, with cursor pagination.
list_role_permissionsList all permissions assigned to a role, as a per-module mapping.
list_role_usersList the users assigned to a role.
list_rolesList the organization's roles (admin profiles).
list_statusesList all custom statuses saved by the authenticated user.
list_team_membersList all members of a team.
list_teamsList teams in the organization, optionally limited to teams the user has joined (joined=true).
list_thread_followersList the users following a thread (returns the full set, no pagination).
list_thread_non_followersList the channel members who are NOT following a thread (returns the full set, no pagination).
list_user_field_layoutsList the layout configurations for user fields.
list_user_fieldsList all custom and system user fields in the organization.
list_user_teamsList all teams a specific user belongs to.
list_usersList organization users with optional server-side filters (search by name/email, status) and cursor pagination.
validate_credentialValidate the Zoho Cliq OAuth credential by listing channels.

Write (39)​

Create or send data.

ToolWhat it does
add_bot_to_channelAdd 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_membersAdd members to a channel by user ID or email.
add_custom_domainAdd a custom domain to the organization.
add_department_membersAdd members to a department.
add_designation_membersAdd members to a designation.
add_reactionAdd an emoji reaction to a message in a chat.
add_role_usersAdd users to a role.
add_team_membersAdd members to a team.
add_thread_followersAdd one or more users as followers of a thread, so they receive reply notifications.
assign_reminder_usersAssign up to 4 users to a reminder, so they are notified when it fires.
create_channelCreate a new channel.
create_database_recordAdd a record to a Cliq database.
create_departmentCreate a department with a name, lead_zuid and at least one initial member in user_ids.
create_designationCreate a designation (job title).
create_eventCreate a calendar event.
create_reminderCreate a reminder for yourself, teammates, a chat, or a specific message.
create_roleCreate a custom role.
create_scheduled_messageSchedule 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_statusCreate a new saved custom status (presence code plus a message) for the authenticated user.
create_teamCreate a new team in the organization.
create_userInvite a new organization user by email.
create_user_fieldCreate a custom user field.
follow_threadFollow a thread as the authenticated user to receive notifications for new replies.
join_channelJoin a channel as the authenticated user.
pin_messagePin a message in a chat for a given duration.
remind_assigneeSend an immediate reminder notification to one specific assignee, bypassing the scheduled time.
remind_assigneesSend an immediate reminder notification to all pending assignees at once, bypassing the scheduled time.
remote_check_inCheck the authenticated user in as working remotely.
send_bot_messageSend a message as a bot to its subscribers, by the bot's unique name (ask the user for it).
send_channel_messagePost a message to a channel, notifying its members.
send_chat_messagePost a message to a chat, notifying its participants.
send_message_to_channelPost a message to a channel by its unique name (not its ID).
send_message_to_userSend a direct message to a user by their email address.
share_file_to_botShare a file to a bot, by the bot's unique name (ask the user for it).
share_file_to_channelShare a file to a channel by its unique name.
share_file_to_chatShare a file to a chat by its chat ID.
share_file_to_userShare a file with a user by their email address.
trigger_bot_callPlace a voice alert from a bot to specific users: Cliq calls each user and reads text aloud, with optional retries and buttons.
upload_event_attachmentUpload a file to your calendar so it can be attached to events.

Delete or overwrite (58)​

Remove or replace existing data.

ToolWhat it does
add_transient_statusSet a temporary (transient) status that automatically expires at a given time.
approve_channelApprove a newly created organization-level channel that is awaiting approval (status 'pending').
archive_channelArchive a channel to stop new messages.
bulk_delete_remindersDelete multiple reminders by their IDs in one call (maximum 20).
delete_channelDelete a channel permanently by ID.
delete_completed_remindersDelete all reminders that are marked complete, in one call.
delete_custom_domainDelete the organization's custom domain.
delete_database_recordDelete a record from a Cliq database permanently.
delete_departmentDelete a department by ID.
delete_designationDelete a designation by ID.
delete_eventDelete a calendar event.
delete_messageDelete a message from a chat permanently.
delete_reactionRemove an emoji reaction from a message.
delete_reminderDelete a reminder by its ID.
delete_roleDelete a role by ID.
delete_statusDelete a saved custom status by its ID.
delete_teamDelete a team from the organization by ID.
delete_transient_statusClear the authenticated user's current transient status before it expires.
delete_user_fieldDelete a custom user field by ID.
dismiss_snoozed_reminderDismiss the snooze on a snoozed reminder, so it reverts to its original fire time.
leave_channelLeave a channel as the authenticated user.
leave_group_chatRemove the authenticated user from a group chat or channel.
mark_reminder_completeMark a reminder as complete by its ID.
mark_reminder_incompleteMark a reminder as incomplete (reopen it) by its ID.
mute_chatMute notifications for a chat while keeping the user an active participant.
reject_channelReject a newly created organization-level channel that is awaiting approval (status 'pending').
remote_check_outCheck the authenticated user out from remote work.
remove_channel_membersRemove one or more members from a channel by user ID or email.
remove_department_membersRemove members from a department.
remove_designation_membersRemove members from a designation.
remove_role_usersRemove users from a role.
remove_team_memberRemove a member from a team by user ID.
remove_thread_followersRemove one or more users from a thread's followers, so they stop receiving reply notifications.
snooze_reminderSnooze a reminder to delay its notification by a duration (in milliseconds).
unarchive_channelUnarchive a channel to resume messaging.
unassign_reminder_userUnassign a user from a reminder, so they stop being notified.
unfollow_threadStop following a thread as the authenticated user, to stop receiving reply notifications (also used to leave a thread conversation).
unmute_chatRestore notifications for a previously muted chat.
unpin_messageRemove the pinned (sticky) message from a chat.
update_channelUpdate a channel's name, description, and/or thread auto-follow setting by ID.
update_channel_member_roleChange a member's role in a channel.
update_current_statusSet a saved status as the authenticated user's current active status, by status ID.
update_database_recordUpdate fields of a record in a Cliq database.
update_departmentUpdate a department's details.
update_designationUpdate a designation's title.
update_eventUpdate a calendar event.
update_event_statusUpdate your RSVP status for an event: accepted, tentative, declined, or yet_to_respond.
update_mail_configurationUpdate the organization's global mail configuration.
update_messageEdit the text of an existing message in a chat.
update_reminderUpdate a reminder's content and/or fire time.
update_roleUpdate a role's name and description.
update_role_permissionsUpdate a role's permissions.
update_teamUpdate a team's name and/or description by ID.
update_thread_stateSet a thread's state to 'closed' (stop new replies) or 'open' (reopen it).
update_userUpdate a user's profile fields by ID.
update_user_fieldUpdate a user field's name, flags (mandatory, encrypted, edit_permission) or options.
upsert_map_tickerAdd or update tickers (live markers) on a widget's map view.
verify_custom_domainVerify ownership of the organization's custom domain by setting its status to 'active'.
⌘J