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

# Zendesk

> Create alerts from support tickets and correlate customers.

| Property         | Value        |
| ---------------- | ------------ |
| **Type**         | Incoming     |
| **Level**        | Organization |
| **Auto-resolve** | No           |

Zendesk sends support ticket data to Warrn via webhook. Warrn creates an alert for each ticket, correlates the ticket requester to a customer record, and links ticket-driven alerts to incidents when applicable.

## Setup

<Steps>
  <Step title="Connect Zendesk in Warrn">
    In Warrn, go to **Settings > Integrations**. Click **Connect Zendesk** to authorize via OAuth. This grants Warrn read access to your Zendesk instance.
  </Step>

  <Step title="Verify the connection">
    After authorization, Warrn runs a connection test against your Zendesk account. Confirm the test passes before proceeding.
  </Step>

  <Step title="Configure webhook triggers in Zendesk">
    In Zendesk, create a webhook or trigger that sends ticket data to Warrn when tickets are created or updated. Warrn deduplicates by `zendesk_ticket_id`, so repeat payloads for the same ticket increment the occurrence count.
  </Step>
</Steps>

## How it works

When Warrn receives a ticket payload from Zendesk:

1. The ticket is converted to alert data (name, severity, description, metadata).
2. Warrn checks for an existing alert with the same `zendesk_ticket_id`. If found, the occurrence count is incremented instead of creating a duplicate.
3. The ticket requester email is matched against customer records in Warrn. If a match is found, the customer is linked to the alert.
4. If the alert is associated with an incident, a customer impact record is created automatically.