Beam Help
Get help now

How-to · Zoho DESK

How to list contacts in Zoho Desk

Retrieve all contacts or filter by specific criteria.

Listing contacts in Zoho Desk is straightforward once you know where to look — the Contacts module lives under the Customers tab and offers several built-in views to help you find and manage your end-users quickly.


Why this matters


Support agents frequently need to pull up a customer's contact record before creating or updating a ticket. Zoho Desk organises contacts and accounts together under a dedicated Customers section, making it easy to search, filter, and act on customer data without leaving the helpdesk. Whether you're onboarding new customers, cleaning up duplicates, or linking records to a CRM, knowing how to navigate the contacts list is a foundational skill. As independent experts (not official Zoho support), the Beam Help team walks you through the process below.


---


Step-by-step


Step 1. Sign in to your Zoho Desk portal and locate the Customers tab in the top navigation bar. Both Contacts and Accounts are accessible from this section. [8]


Step 2. Click Contacts within the Customers module. This opens the contacts list, which displays individual customers and end-users who have submitted support tickets through your enabled channels. [8]


Step 3. Use the List Views to filter and group the contacts shown. Zoho Desk provides standard views — for example, contacts added today or contacts mapped with Zoho CRM — and agents can also create custom views based on their own criteria. [3]


Step 4. To narrow down a specific contact, use the search bar at the top of the list. Agents typically search by a customer's name or email address to quickly open the relevant record. [3]


Step 5. Click any contact's name in the list to open their detail page, where you can review their profile, associated account, ticket history, and any linked third-party records. [8]


Step 6. If you need to perform actions across several records at once — such as updating a field or reassigning contacts — use the mass and bulk actions available within the Contacts module to apply changes to multiple records simultaneously. [8]


Step 7. To add a brand-new contact manually, look for the Add Contact button within the module. Fill in the required fields (name, email address, phone number) and save the record. The new contact will then appear in your contacts list. [3]


Step 8. Agents can also add a ticket directly from a contact's record. Open the contact, then use the option to submit a ticket on their behalf — useful when a customer calls in rather than submitting through a self-service channel. [3]


---


Common pitfalls


  • Contact not appearing in the list? Check which List View is active. A filtered view (e.g., "Contacts added today") may be hiding records that exist but don't match the current criteria. Switch to an "All Contacts" view to see the full list. [3]

  • Contacts linked to accounts behaving unexpectedly? Remember that a contact can belong to only one account in Zoho Desk. If you're trying to associate a contact with a different account, you'll need to remove the existing account link first. [8]

  • Spam contacts cluttering the list? Zoho Desk includes spam contact management tools. If your list is filling up with newsletter addresses or unsolicited senders, review the spam management settings to keep your contacts list clean. [8]

  • Pushing contacts to Zoho FSM? If you're using the Zoho FSM integration and attempt to push a Desk contact whose parent account hasn't yet been synced to FSM, you will encounter an error. Always ensure the parent account is pushed to FSM before pushing the associated contact. [2]

---


What to check


  • Verify your List View — confirm you're viewing "All Contacts" (or the appropriate custom view) so no records are inadvertently filtered out. [3]
  • Confirm module permissions — ensure your agent role has access to the Contacts module under the Customers tab; restricted roles may see a limited view or no contacts at all. [8]
  • Check CRM sync status — if your contacts should be mapped from Zoho CRM, use the CRM-mapped contacts view to confirm the sync is working as expected. [3]

Sources cited

  1. [1] Contacts
  2. [2] Zoho FSM | Integrating Zoho FSM with Zoho Desk
  3. [3] Desk | Contacts And Accounts | Knowledge Base
  4. [4] server.py: build_zoho_links
  5. [5] Zoho Community | Connect, network, and share on Zoho Forums