Zendesk

Sync data from your warehouse to Zendesk Support. Keep your Zendesk Users, Organizations, and Tickets enriched with the latest customer data.

Prerequisites

A Zendesk Support account
Your Zendesk subdomain (e.g., mycompany for mycompany.zendesk.com)
For API Token auth: A Zendesk admin email and API token
For OAuth: A Zendesk admin account

Authentication

Zendesk supports two authentication methods:

API Token

In Zendesk, go to Admin Center > Apps and integrations > APIs > Zendesk API
Enable Token Access
Create a new API token
In SignalSmith, enter your Admin Email and the API Token

OAuth 2.0

Click Connect with OAuth in SignalSmith
Sign in to your Zendesk account
Authorize the requested permissions

Configuration

Field	Type	Required	Description
Subdomain	Text	Yes	Your Zendesk subdomain (e.g., `mycompany` for `mycompany.zendesk.com`)

Target Settings

Field	Type	Required	Description
Object Type	Select	Yes	The Zendesk object to sync to: Users, Organizations, or Tickets

Supported Operations

Sync Modes

Mode	Supported
Upsert	Yes
Insert	Yes
Update	Yes
Mirror	—

Audience Sync Modes

Mode	Supported
Add	Yes
Remove	Yes
Mirror	Yes
Upsert	Yes

Features

Field Mapping: Yes
Schema Introspection: Yes — SignalSmith reads custom field definitions from the Zendesk Fields API

Required Mapping Fields

Object	Required Fields
Users	name, email
Organizations	name
Tickets	subject, description

Troubleshooting

Authentication failed: invalid credentials

For API Token auth, ensure the email is the admin email and the token is correct. API tokens are distinct from passwords. For OAuth, reconnect to refresh the token.

Subdomain not found

Verify your subdomain matches your Zendesk URL. For https://mycompany.zendesk.com, enter mycompany.

Cannot create tickets

Ticket creation requires the tickets:write scope. Ensure your API token or OAuth grant includes ticket permissions.

Rate limiting

Zendesk enforces per-minute API rate limits. SignalSmith handles rate limiting with automatic retries.

Dynamics 365 Intercom