Skip to main content
Z

Zendesk Integration

Two-way ticket sync with auto-update statuses

βœ“ Official Integration API Token Auth 5-Minute Setup

The Zendesk integration lets your Customer Support AI agent create tickets, auto-update statuses, add comments, and sync ticket data β€” automatically escalating conversations when the AI determines human review is needed.

✨ What Your Agents Can Do

βœ“ Create tickets from AI conversations
βœ“ Auto-update ticket status (open β†’ solved)
βœ“ Add internal comments and notes
βœ“ Set ticket priority (low / normal / high / urgent)
βœ“ Tag tickets for routing and reporting
βœ“ Receive webhook events when tickets update

Setup Guide

1

Get your Zendesk API token

In Zendesk Admin Center, go to:

Admin Center β†’ Apps & Integrations β†’ APIs β†’ Zendesk API β†’ Add API token

Copy the token β€” it won't be shown again.

2

Connect in the Hub

Go to Integrations β†’ Support and select Zendesk. Enter:

  • subdomain β€” the part before .zendesk.com
  • Admin email β€” your Zendesk admin email address
  • API token β€” the token you just generated
3

Set HELPDESK_PROVIDER on your agent

In your agent's environment variables, set:

HELPDESK_PROVIDER=zendesk
ZENDESK_SUBDOMAIN=yourcompany
ZENDESK_BASIC_AUTH_TOKEN=<base64 of admin@example.com/token:yourtoken>

Generate the base64 token: echo -n "admin@example.com/token:yourtoken" | base64

4

(Optional) Set up webhooks

To receive ticket updates back into your agent, configure a Zendesk webhook pointing to:

POST https://your-n8n.domain/webhook/zendesk-events

⚑ When Does a Ticket Get Created?

The Customer Support AI automatically creates a Zendesk ticket when:

  • β†’ The AI's confidence score drops below 0.40
  • β†’ Customer explicitly asks to speak to a human
  • β†’ Priority is flagged as high or critical
  • β†’ Category is refund_requested, legal_request, or account_deletion

Troubleshooting

❌ 401 Unauthorized

Check your subdomain spelling and confirm the API token is correct. Verify the email matches your Zendesk admin account.

❌ Tickets not creating

Confirm HELPDESK_PROVIDER=zendesk is set on the agent and both ZENDESK_SUBDOMAIN and ZENDESK_BASIC_AUTH_TOKEN are present.

❌ 403 Forbidden on ticket update

Your API token may not have write permissions. Ensure "Token access" is enabled in Zendesk Admin β†’ API settings.

Ready to connect Zendesk?

Takes under 5 minutes. Your agents start creating tickets automatically.

Connect Zendesk β†’