Zoho Cliq icon

Zoho Cliq

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

Actions168

User Status → Add a New Status

AI-generated

Summary

Create a new reusable custom user status for the authenticated OAuth user in Zoho Cliq by specifying a presence code and a custom status message.

Inputs

  • Enable AI Error Mode — Whether to return errors as output items instead of stopping execution, useful for workflows that should recover from API errors.
  • Input Mode (required) — Choose 'Using Fields Below' for guided inputs or 'Using JSON' to send the exact API body for the new status.
  • Code (required) — Presence code indicating the user's status: 'available' (online), 'busy' (do not disturb), or 'invisible' (hidden presence). Required when using structured input mode.
  • Message (required) — Custom status text displayed in Zoho Cliq that describes the user's status. Required when using structured input mode.
  • Status Definition (JSON) (required) — A JSON object representing the full API body for the status, including the required 'code' and 'message' fields. Used only when input mode is 'Using JSON'.

Output shape

a single object representing the created user status as returned by the Zoho Cliq API

Requires the OAuth scope 'ZohoCliq.Profile.CREATE'. The operation affects only the current authenticated user by creating one reusable custom status. Errors can be returned as output items if AI Error Mode is enabled.

Examples

Example 1: Create a new user status 'Busy' with a custom message

Enable AI Error Mode: false, Input Mode: Using Fields Below, Code: busy, Message: In a meeting, will respond soon!,

Example 2: Create a user status using raw JSON input

Enable AI Error Mode: true, Input Mode: Using JSON, Status Definition: {"code":"invisible","message":"Stepped out"}

Links

Discussion