Zoho CliqInstall

Summary

Create a new user in Zoho Cliq by specifying user details either through structured fields, agent/tool setup fields, or raw JSON input. Supports adding personal information, organizational role assignments, location details, and custom fields, with options to normalize name casing and handle API errors gracefully.

Inputs

• Input Mode (required) — Choose the payload input method: structured fields, agent/tool setup fields optimized for AI agents, or raw JSON in exact API format.
• Email ID (required) — Email address for the new user.
• First Name — User's first name.
• Last Name — User's last name.
• Normalize Name Casing — Optionally convert first and last names to a normalized casing (capitalize first letter only).
• Employee ID — Organization-specific employee identifier.
• Nickname — Nickname shown in Zoho Cliq.
• Mobile — Mobile phone number.
• Phone — Desk phone number.
• Extension — Desk phone extension.
• Image Data — Base64-encoded profile image content. Must be raw image file bytes encoded, not a simple URL or arbitrary string. Supported formats include PNG, JPEG, GIF, etc.
• Channel IDs — Comma-separated channel IDs to assign the user to.
• Department ID — ID of a department to attach the user to (one department only).
• Designation ID — ID of the user's designation (single designation only).
• Reporting To ZUID — ZUID of the manager to whom the user reports (one manager only).
• Team IDs — Comma-separated team IDs to add the user to.
• Country — ISO 3166-1 alpha-2 country code.
• Language — ISO 639-1 two-letter language code.
• Timezone — IANA timezone identifier (e.g., America/New_York).
• Work Location — User's work location.
• Custom Fields — JSON object specifying additional custom fields keyed by their unique names.
• Users Payload (JSON) (required) — When using raw JSON input mode, provide the full API payload wrapped in a top-level users array with user detail objects.
• Enable AI Error Mode — When enabled, API errors are returned as output items without stopping execution, recommended for AI Tool workflows.

Output shape

a single record containing the API response data for the created user.

Returns data on the newly created user as provided by the Zoho Cliq API. If AI error mode is enabled, errors are returned as output instead of halting execution. When using JSON input mode, ensure the payload structure matches API requirements with a users array wrapper.

Examples

Example 1: Create a user using structured fields.

Set Input Mode to 'Using Fields Below'. Provide required Email ID, and optionally supply names, contact numbers, department, designation, channels, and other details. Toggle normalization and additional fields as needed.

Example 2: Create a user with raw JSON.

Set Input Mode to 'Using JSON' and provide a valid JSON user creation payload wrapped in a users array (e.g., { "users": [ { "email_id": "..." } ] }).

Links

• n8n community nodes installation guide