> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Zoho Desk Webhook Setup Guide

> Configure Zoho Desk to deliver events to StackOne.

## Prerequisites

The connector should already be set up, with a Connector Profile and a Linked Account. See [Getting Started](https://docs.stackone.com/connectors/zoho-desk.md#getting-started) on the Zoho Desk connector page.

## How Zoho Desk webhooks are set up

There is nothing to configure in Zoho Desk and no URL to copy. When the account is connected, StackOne creates one Zoho Desk webhook named StackOne Integration that covers every event below, and deletes it when the account is disconnected.

<ul>
  <li>No callback URL to paste. Zoho Desk checks the StackOne address when the webhook is created, and StackOne answers that check for you.</li>
  <li>Zoho Desk sends every supported event to StackOne. Only the events you enable in StackOne are delivered to your webhooks.</li>
  <li>The webhook counts toward your edition's limit on enabled webhooks (5 on **Professional**, 10 on **Enterprise**, 20 on **Ultimate**).</li>
  <li>The **Webhook** permission is set per profile under **Setup** > **Users and Control** > **Permissions** > **Profiles**.</li>
</ul>

## Available webhook events

The following Zoho Desk events can be enabled. Only events selected in StackOne are delivered.

**1. Ticket events**

Events on the lifecycle of a ticket. Ticket events also include changes made by time-based **Supervise Rules**.

<ul>
  <li>**Ticket Created** (`Ticket_Add`) — Fired when a ticket is created</li>
  <li>**Ticket Updated** (`Ticket_Update`) — Fired when a ticket changes, including when it is moved to the **Recycle Bin**. The payload includes the ticket's previous state</li>
  <li>**Ticket Deleted** (`Ticket_Delete`) — Fired when a ticket is permanently deleted from the **Recycle Bin**</li>
</ul>

**2. Ticket activity events**

Events on comments, conversations and attachments within a ticket.

<ul>
  <li>**Ticket Comment Added** (`Ticket_Comment_Add`) — Fired when a comment is added to a ticket</li>
  <li>**Ticket Comment Updated** (`Ticket_Comment_Update`) — Fired when a comment on a ticket is edited</li>
  <li>**Ticket Thread Added** (`Ticket_Thread_Add`) — Fired when a reply is sent or a message arrives on a ticket, including automatic bounce messages</li>
  <li>**Ticket Attachment Added** (`Ticket_Attachment_Add`) — Fired when a file is attached to a ticket</li>
  <li>**Ticket Attachment Deleted** (`Ticket_Attachment_Delete`) — Fired when a ticket attachment is permanently deleted from the **Recycle Bin**</li>
</ul>

**3. Contact events**

Events on contacts, the customers who raise tickets.

<ul>
  <li>**Contact Created** (`Contact_Add`) — Fired when a contact is created, including one created automatically with a new ticket</li>
  <li>**Contact Updated** (`Contact_Update`) — Fired when a contact changes, including when it is moved to the **Recycle Bin**</li>
  <li>**Contact Deleted** (`Contact_Delete`) — Fired when a contact is permanently deleted from the **Recycle Bin**</li>
</ul>

**4. Account events**

Events on accounts, the customer companies that contacts belong to.

<ul>
  <li>**Account Created** (`Account_Add`) — Fired when an account is created</li>
  <li>**Account Updated** (`Account_Update`) — Fired when an account changes, including when it is moved to the **Recycle Bin**</li>
  <li>**Account Deleted** (`Account_Delete`) — Fired when an account is permanently deleted from the **Recycle Bin**</li>
</ul>

**5. Department events**

Events on help desk departments. Zoho Desk has no event for a deleted department.

<ul>
  <li>**Department Created** (`Department_Add`) — Fired when a department is created</li>
  <li>**Department Updated** (`Department_Update`) — Fired when a department changes, such as its name</li>
</ul>

**6. Agent events**

Events on agents, the help desk staff. Moving an agent to another department also counts as an update.

<ul>
  <li>**Agent Created** (`Agent_Add`) — Fired when an agent is invited to the help desk</li>
  <li>**Agent Updated** (`Agent_Update`) — Fired when an agent changes, such as their departments</li>
  <li>**Agent Deleted** (`Agent_Delete`) — Fired when an agent is deleted</li>
</ul>

**7. Webhook check event**

Emitted while the webhook is being set up, not by help desk activity.

<ul>
  <li>**Active Check** (`Webhook_Validation`) — Fired when Zoho Desk checks the StackOne address, which happens when the webhook is created or its address changes. It carries no help desk record</li>
</ul>

## Verify

Your Connector should now be able to receive and process events. Try triggering an event and you should see an Event appear in the Connector logs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.