Skip to main content

​
Overview

Phinite’s Zoho Desk predefined tool lets workspace assistants call Zoho Desk APIs through DevStudio after you save a connection under Integrations → Predefined tools. Manage Zoho Desk help-desk tickets, comments, contacts, accounts, agents, departments, and knowledge-base articles via the Zoho Desk REST API.
Predefined tools require a saved connection before they appear in Graph Studio’s tool picker. See Predefined Tools in GraphStudio.

​
What this integration enables

  • Automate workflows using this predefined tool from agent graphs
  • Connect once under Integrations and reuse across assistants
  • Enable individual subtools per agent in Graph Studio

​
Required credentials

  • Access Token access_token (required)
  • Organization ID org_id (required)
  • Base URL base_url (optional)

​
Setup steps

  1. Zoho API Console → Server-based app → OAuth → exchange code for access token → get Org ID from Desk Setup → Developer Space → APIs.
  2. Log into your Phinite workspace at app.phinite.ai
  3. Navigate to Integrations → Predefined tools
  4. Select Zoho Desk
  5. Click + Add Configuration
  6. Enter the credential fields listed above
  7. Select assistants that should use this connection
  8. Click Save Configuration

​
Configure in Graph Studio

  1. Open an agent in Graph Studio
  2. Select the agent node → Tools tab → Add a new tool
  3. Choose ZohoDeskTool (or search for Zoho Desk)
  4. Select your saved connection or add a new one
  5. Enable the subtools your workflow needs and save

​
Predefined tools

Phinite provides 26 subtools for Zoho Desk:
  • List Tickets: List tickets in Zoho Desk. Supports pagination and filtering.
  • Get Ticket: Get a single ticket by ID from Zoho Desk.
  • Create Ticket: Create a new ticket in Zoho Desk.
  • Update Ticket: Update an existing ticket in Zoho Desk.
  • Delete Ticket: Move a ticket to trash in Zoho Desk.
  • List Ticket Comments: List comments on a ticket in Zoho Desk.
  • Add Ticket Comment: Add a comment to a ticket in Zoho Desk.
  • List Contacts: List contacts in Zoho Desk.
  • Get Contact: Get a single contact by ID from Zoho Desk.
  • Create Contact: Create a new contact in Zoho Desk.
  • Update Contact: Update an existing contact in Zoho Desk.
  • Delete Contact: Delete a contact from Zoho Desk.
  • List Accounts: List accounts (companies) in Zoho Desk.
  • Get Account: Get a single account by ID from Zoho Desk.
  • Create Account: Create a new account (company) in Zoho Desk.
  • Update Account: Update an existing account in Zoho Desk.
  • Delete Account: Delete an account from Zoho Desk.
  • List Agents: List agents in Zoho Desk.
  • Get Agent: Get a single agent by ID from Zoho Desk.
  • List Departments: List departments in Zoho Desk.
  • List Articles: List knowledge-base articles in Zoho Desk.
  • Create Article: Create a knowledge-base article in Zoho Desk.
  • Get Article: Get a single knowledge-base article by ID from Zoho Desk.
  • Update Article: Update an existing knowledge-base article in Zoho Desk.
  • Delete Article: Delete a knowledge-base article from Zoho Desk.
  • Search Records: Search across tickets, contacts, accounts, and articles in Zoho Desk.

​
Documentation & resources

  • Official documentation: https://desk.zoho.com/DeskAPIDocument#Introduction
  • Phinite documentation: Zoho Desk

​
Notes

  • Store API keys and tokens securely; many providers show secrets only once
  • Use separate connections for Dev, UAT, and Prod environments where possible
  • Test with a minimal subtool call after saving credentials