Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zoho Cliq messages API

Messages Module

Zoho Cliq messages API is one of 22 APIs that Zoho Cliq publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 4 JSON Schema definitions.

Tagged areas include messages. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, a JSON-LD context, and 4 JSON Schemas.

This API exposes 6 operations across 6 paths, and defines 7 schemas. It is described by OpenAPI 3.0.0, at version 1.0.0.

Requests are made against a single base URL, https://cliq.zoho.com/api/v3.

6 operations 6 paths 7 schemas 1 DELETE1 GET4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Base URL
https://cliq.zoho.com/api/v3
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Zoho Cliq messages API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (Cliq_Auth) using the implicit flow, exposing 7 scopes.

Paths & Operations 6

Across 6 paths, the API surfaces 6 operations — 1 DELETE, 1 GET, 4 POST. Each is listed below with its method, path, parameters, and response codes.

messages 6

Messages Module

DELETE
/chats/{CHAT_ID}/messagess
Delete multiple messages
deleteMultipleMessagesV3 4 params → 200400401403404429500
POST
/channelsbyname/{CHANNEL_UNIQUE_NAME}/messages
Post message in a channel with CHANNELUNIQUENAME
postMessageInChannelByChannelUniqueName 4 params body → 200400401403404405406429
POST
/channels/{CHANNEL_ID}/messages
Post message in a channel with CHANNELID
postMessageInChannelByChannelId 4 params body → 200400401403404405406429
POST
/chats/{CHAT_ID}/messages
Post message in chat
Post message in chat 1 param body → 200400401403404405406429
POST
/messages
Forward Messages
Forward Messages body → 200400401403404405406429
GET
/messages/search
Search Messages
searchMessagesV3 22 params → 200400401403429500

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are post-message-in-chat-request (4 properties), search-messages-response (3 properties), post-message-in-a-channel-request (3 properties), forward-messages-request (2 properties). Each schema is shown below with its type and property counts.

post-message-in-chat-request
object
Request object to send a message in a chat.
4 properties 1 required
post-message-in-a-channel-request
object
Request object to post a message in a channel.
3 properties 1 required
post-message-in-a-chat-response
object
Response object for posting messages in a chat/user
1 property
forward-messages-response
object
Response object after forwarding messages. Uses a partial-success model.
1 property
post-message-in-a-channel-response
object
Response object after posting a message in a channel.
1 property
forward-messages-request
object
Request object to forward one or more messages from a source chat to other chats or users.
2 properties 2 required
search-messages-response
object
Response object for message search results containing matching messages and pagination information.
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zoho-cliq-messages-api-openapi.yml Raw ↑

Other APIs Zoho Cliq publishes across the network.

Zoho Cliq Bots API
Zoho Cliq buttons API
Zoho Cliq chats API
Zoho Cliq dndsettings API
Zoho Cliq Extensions API
Zoho Cliq Functions API
Zoho Cliq keyboardshortcuts API
Zoho Cliq mentions API
Zoho Cliq messageactions API
Zoho Cliq messagecards API
Zoho Cliq messageformat API
Zoho Cliq mobilesettings API