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
In Goodweek, go to Integrations.
Find Zoho Desk and click Connect.
You will be redirected to Zoho, where you will be asked to sign in and authorize access.
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.
