Skip to main content

Zoho Desk Integration - Setup Guide

Connect your Zoho Desk account to Goodweek to manage support tickets, contacts, agents, and departments directly from your AI workspace.

A
Written by Antoine Stempien

Connect your Zoho Desk account to Goodweek to manage support tickets, contacts, agents, and departments directly from your AI workspace.

ℹ️ Governance note

Goodweek will never exceed the access levels granted to the user within Zoho Desk, guaranteeing alignment with your organization's governance policies. Outcomes and available features may vary depending on each user's specific permissions and authenticated access.

📋 Prerequisites

Before any user can see and connect the Zoho Desk integration, your organization admin must first enable it from the Goodweek Admin Panel under the Integrations tab.

Admin Setup

The Zoho Desk integration uses OAuth 2.0 and does not require any admin-level approval within Zoho before users can connect.

⚠️ Regional data centers

Zoho operates data centers in multiple regions (US, EU, AU, IN, JP). During the OAuth connection flow, make sure to sign in with the account associated with your correct regional data center.

User Connection

  1. In Goodweek, go to Integrations.

  2. Find Zoho Desk and click Connect.

  3. You will be redirected to Zoho, where you will be asked to sign in and authorize access.

  4. Click Accept to grant access and return to Goodweek.

Important Notes

  • Each user must connect their own account individually.

  • Goodweek can only access the tickets, contacts, and departments that your individual Zoho Desk profile has permission to see.

  • You can revoke Goodweek's access at any time from Zoho Desk → Setup → Developer Space → OAuth Apps → Composio → Revoke.


Available Tools

Tool

Description

Type

List Tickets

Lists support tickets with optional filtering and pagination.

Read

Get Ticket

Retrieves full details for a specific support ticket by its ID.

Read

Get Ticket Latest Thread

Fetches the most recent conversation thread on a ticket.

Read

Get Ticket Thread

Fetches a specific conversation thread within a ticket by thread ID.

Read

List Ticket Conversations

Lists all conversation threads for a specific ticket.

Read

Get Ticket Resolution

Retrieves the resolution note recorded on a specific ticket.

Read

Create Ticket

Creates a new support ticket with subject, description, department, and requester details.

Write

Update Ticket

Updates an existing ticket's status, priority, assignee, description, or other fields.

Write

Download Ticket Attachment

Downloads a file attachment from a Zoho Desk ticket by attachment ID.

Read

Upload Ticket Attachment

Uploads a file attachment to a specific Zoho Desk ticket.

Write

List Contacts

Lists contacts in Zoho Desk with optional filtering and pagination.

Read

Get Contact

Retrieves full details for a specific Zoho Desk contact by ID.

Read

Get Contacts By IDs

Fetches multiple contacts by their IDs in a single request.

Read

Create Contact

Creates a new contact in Zoho Desk with name, email, and other details.

Write

List Contact Accounts

Lists accounts associated with a specific Zoho Desk contact.

Read

Update Account

Updates an existing Zoho Desk account's information.

Write

List Agents

Lists all agents in the Zoho Desk organization with optional filtering and pagination.

Read

Get Agent

Retrieves full details for a specific Zoho Desk agent by ID.

Read

Get Agents Count

Returns the total count of agents, optionally filtered by status.

Read

List Departments

Lists all departments in the Zoho Desk organization.

Read

Get Department

Retrieves full details for a specific department by ID.

Read

Get Departments Count

Returns the total count of departments.

Read

List Teams in Department

Lists all teams within a specified Zoho Desk department.

Read

List Views

Lists all ticket views (saved filters) in the Zoho Desk organization.

Read

List Roles

Lists all roles configured in Zoho Desk.

Read

List Organizations

Lists all organizations the current user belongs to.

Read

Search

Searches across Zoho Desk modules including tickets, accounts, contacts, and tasks by keyword.

Read

Update Many Tasks

Updates multiple tasks in a single API call.

Write

Use Cases

  • Create and update support tickets from conversations. Log new customer support tickets in Zoho Desk directly from a Goodweek conversation — with subject, description, department, and priority — without switching tools.

  • Review ticket status and threads. Retrieve open tickets, check the latest thread on a specific ticket, or look up a ticket's resolution from Goodweek to get a quick overview of customer issues.

  • Search across tickets, contacts, and accounts. Find specific support records by keyword from within Goodweek without navigating the Zoho Desk UI.

  • Manage contacts linked to tickets. Look up or create Zoho Desk contacts directly from a conversation to ensure tickets are associated with the correct customer record.


Troubleshooting

Connected but data from the wrong organization appears

Make sure you signed in with the Zoho account associated with your correct regional data center during the connection flow. Disconnect and reconnect if needed.

Integration not visible in Goodweek

Make sure your organization admin has enabled the Zoho Desk integration from the Goodweek Admin Panel under the Integrations tab.

References

Did this answer your question?