> For the complete documentation index, see [llms.txt](https://docs.siit.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.siit.io/integrations/ticketing/zendesk.md).

# Zendesk

Connect Zendesk to Siit to escalate requests into Zendesk tickets with one click.

<figure><img src="https://451675063-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fz9xmM8V3atukfr2XaElR%2Fuploads%2F9ZKWtDagfNm6R3CVDxeg%2FSiit_Zendesk.jpg?alt=media&amp;token=c49b8ca0-faa5-4a02-b342-d2fced16b615" alt=""><figcaption></figcaption></figure>

Escalate Siit requests to Zendesk specialist groups with one click. Custom field mapping ensures every escalated ticket arrives with the right context, so your support team triages faster, not from scratch.

### What you get

* **One-click escalation from any request.** Click **Escalate ticket** in the request side panel, pick a Zendesk group and ticket form, and a linked ticket is created with the Siit context pre-filled.
* **Workflow-driven ticket creation.** Use **Create Zendesk ticket** as a workflow step, with field mapping and approval gating where needed.
* **IT Agent native support.** `/zendesk create ticket` is available inside IT Agent playbooks, with optional approval.
* **Custom field mapping.** Map Siit form fields and request attributes to your Zendesk custom fields, so escalated tickets land with the right context every time.
* **Audit trail.** Every Zendesk action triggered from Siit is recorded on the request timeline.

### How it works

When a Siit request needs to be handled in Zendesk:

1. From the request side panel, click **Escalate ticket** and pick **Zendesk**.
2. Choose the group, ticket form, priority, and any required fields. Custom fields configured in **Settings → Workspace → Integration library → Zendesk** appear automatically.
3. Submit. Siit creates the Zendesk ticket, links it back to the Siit request, and posts the link on both sides.

The same flow is available in workflows (as a **Create Zendesk ticket** action) and in IT Agent playbooks (via the `/zendesk create ticket` slash command).

### What syncs from Zendesk

* **Tickets created from Siit** — every escalated ticket is tracked with its Zendesk ticket ID and link.
* **Sync** is fully configurable and per-direction (`Settings → Workspace → Integration library → Zendesk → Settings`):
  * **Resolution** — resolve on one side, close on the other (with status mapping).
  * **Assignee** — reassignments mirror across.
  * **Notes** — internal notes sync.
  * **Messages** — new messages sync.
  * **Links** — bidirectional links stay visible on both sides.

### Custom field mapping

Map Siit data to Zendesk custom fields so escalated tickets arrive with the right metadata — request ID, requester, service, priority, anything specialist teams need to triage quickly.

Set this up in **Settings → Workspace → Integration library → Zendesk → Field mapping**. For the full setup guide, see [Custom field mapping](https://help.siit.io/custom-field-mapping).

### Before you connect

* A Zendesk admin to authorize the connection.
* A clear idea of which Zendesk group(s) and ticket form(s) you want to escalate to.
* Optional: a dedicated "Siit Integration" Zendesk agent, so the integration survives admin turnover.

### Connect Zendesk

1. In Siit, go to **Settings → Workspace → Integration library**, find **Zendesk** in the Ticketing section, and click **Connect**.
2. Enter your Zendesk subdomain (the `yourcompany` part of `yourcompany.zendesk.com`).
3. Sign in as a Zendesk admin and approve the requested scopes.
4. Pick the group(s) and ticket form(s) you want available for escalation.
5. Configure default ticket form, priority, and field mapping.
6. Test by escalating a sample request from Siit to Zendesk.

Need a more detailed walkthrough? Reach out to support via the in-app chat.

### After the connection

* **Try the side panel.** From any request, click **Escalate ticket → Zendesk** and create a test ticket.
* **Configure field mapping.** Map your Siit fields to the Zendesk custom fields specialist teams rely on.
* **Build your first workflow.** A common starter: "when service = 'Customer escalation', auto-create a Zendesk ticket in the support group."

### Common workflows

**Customer support escalation.** *Trigger: Service = "Customer escalation". Actions: Create Zendesk ticket in the support group → Set Siit priority to High → DM requester with the Zendesk link.*

**Specialist team handoff.** *Trigger: Tag "advanced-support" added. Actions: Manager approval → Create Zendesk ticket → Notify requester.*

**Dedicated helpdesk routing.** *Trigger: Requester's department = "External". Action: Create Zendesk ticket in the external-support group, pre-filling the requester's company from their profile.*

### IT Agent integration

Inside an IT Agent playbook, use `/zendesk create ticket` to let the agent escalate autonomously — with approval gating on the action when you want a human in the loop.

A common playbook: an employee reports a complex issue in Slack → IT Agent gathers context → requests manager approval → creates a Zendesk ticket → posts the link back to the employee.

See IT Agent for playbook examples.

### Tips

* **Use a dedicated service account** for the Zendesk connection so it survives individual admin turnover.
* **Start with one group and one ticket form.** Map fields and test thoroughly with one path before expanding.
* **Keep Siit as the employee surface.** Employees stay in Slack, Teams, or the Siit Portal. The Zendesk ticket is internal — only specialists need to see it.

### Help Center guides

* [Custom field mapping](https://help.siit.io/custom-field-mapping) — map Siit data to Zendesk custom fields

### Troubleshooting

**"Authorization failed" on connect.** The admin signing in lacks Zendesk admin rights, or the Zendesk account has restricted third-party app installs. Try with an admin who has full access.

**Group missing from the destination picker.** The Siit Zendesk user lacks access to that group. Update group membership in Zendesk and re-sync.

**Custom field not appearing in mapping.** The field may be tied to a specific ticket form or set as inactive. Confirm the field is active and on the ticket form, then re-run the mapping step.

**"Ticket created" but no link in Siit.** The Zendesk ticket was created but the back-link save failed. Open the request timeline — the Zendesk ticket ID is logged. Manually re-link if needed.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.siit.io/integrations/ticketing/zendesk.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.