Zendesk Connector

Prerequisites

• A Zendesk Support account (any plan: Team, Growth, Professional, Enterprise)
• An Agent or Admin user account

Step 1: Enable API Token Access

1. Log into Zendesk as an Admin
2. Go to Admin Center (gear icon in the sidebar)
3. Navigate to Apps and integrations > Zendesk API > Settings
4. Ensure Token Access is enabled
5. Click Save

Step 2: Generate an API Token

1. On the same Zendesk API settings page, click Add API token
2. Enter a description (e.g., Landed sync)
3. Click Save
4. Copy the token immediately -- it will only be shown once

Step 3: Find Your Subdomain

Your Zendesk subdomain is the part before .zendesk.com in your browser URL when logged into Zendesk.

Example: If your URL is https://mycompany.zendesk.com/..., your subdomain is mycompany.

Step 4: Configure in Landed

Field	Value
Email	The email address of the Zendesk agent/admin account
API Token	The token you generated in Step 2
Subdomain	Your Zendesk subdomain (e.g., mycompany)

Required Permissions

The user whose email you provide must have:

• Agent role (minimum): can sync tickets, users, organizations, and groups
• Admin role (recommended): full access to all streams including satisfaction ratings and audit logs

Available Streams

Stream	Description	Sync Mode	Min Role
tickets	Support tickets with subject, status, priority	Incremental	Agent
users	End-users and agents	Incremental	Agent
organizations	Customer organizations	Incremental	Agent
groups	Agent groups	Full refresh	Agent
ticket_metrics	Ticket response/resolution time metrics	Incremental	Agent
ticket_comments	Ticket conversation history	Incremental	Agent
satisfaction_ratings	CSAT survey responses	Incremental	Admin
tags	All tags in use	Full refresh	Agent

Common Errors

Error	Cause	Fix
401 Unauthorized	Wrong email, token, or subdomain	Verify all three fields are correct
403 Forbidden	User lacks required role	Ensure the user has Agent or Admin role
404 Not Found	Wrong subdomain	Check your subdomain matches your Zendesk URL
Too Many Requests (429)	Rate limited	Landed handles rate limiting automatically

Data Notes

• Zendesk API uses cursor-based pagination. Landed handles this automatically.
• Deleted tickets are soft-deleted and tracked via _landed_deleted_at.
• Timestamps are in UTC.