LogoLogo
  • 🦩Overview
  • 💾Datasets
    • Overview
    • Core Concepts
      • Columns & Annotations
      • Type & Property Mappings
      • Relationships
    • Basic Datasets
      • dbt Integration
      • Sigma Integration
      • Looker Integration
    • SaaS Datasets
    • CSV Datasets
    • Streaming Datasets
    • Entity Resolution
    • AI Columns
      • AI Prompts Recipe Book
    • Enrichment Columns
      • Quick Start
      • HTTP Request Enrichments
    • Computed Columns
    • Version Control
  • 📫Syncs
    • Overview
    • Triggering & Scheduling
    • Retry Handling
    • Live Syncs
    • Audience Syncs
    • Observability
      • Current Sync Run Overview
      • Sync History
      • Sync Tracking
      • API Inspector
      • Sync Alerts
      • Observability Lake
      • Datadog Integration
      • Warehouse Writeback
      • Sync Lifecycle Webhooks
      • Sync Dry Runs
    • Structuring Data
      • Liquid Templates
      • Event Syncs
      • Arrays and Nested Objects
  • 👥Audience Hub
    • Overview
    • Creating Segments
      • Segment Priorities
      • Warehouse-Managed Audiences
    • Experiments and Analysis
      • Audience Match Rates
    • Activating Segments
    • Calculated Columns
    • Data Preparation
      • Profile Explorer
      • Exclusion Lists
  • 🧮Data Sources
    • Overview
    • Available Sources
      • Amazon Athena
      • Amazon Redshift
      • Amazon S3
      • Azure Synapse
      • ClickHouse
      • Confluent Cloud
      • Databricks
      • Elasticsearch
      • Kafka
      • Google AlloyDB
      • Google BigQuery
      • Google Cloud SQL for PostgreSQL
      • Google Pub/Sub
      • Google Sheets
      • Greenplum
      • HTTP Request
      • HubSpot
      • Materialize
      • Microsoft Fabric
      • MotherDuck
      • MySQL
      • PostgreSQL
      • Rockset
      • Salesforce
      • SingleStore
      • Snowflake
      • SQL Server
      • Trino
  • 🛫Destinations
    • Overview
    • Available Destinations
      • Accredible
      • ActiveCampaign
      • Adobe Target
      • Aha
      • Airship
      • Airtable
      • Algolia
      • Amazon Ads DSP (AMC)
      • Amazon DynamoDB
      • Amazon EventBridge
      • Amazon Pinpoint
      • Amazon Redshift
      • Amazon S3
      • Amplitude
      • Anaplan
      • Antavo
      • Appcues
      • Apollo
      • Asana
      • AskNicely
      • Attentive
      • Attio
      • Autopilot Journeys
      • Azure Blob Storage
      • Box
      • Bloomreach
      • Blackhawk
      • Braze
      • Brevo (formerly Sendinblue)
      • Campaign Monitor
      • Canny
      • Channable
      • Chargebee
      • Chargify
      • ChartMogul
      • ChatGPT Retrieval Plugin
      • Chattermill
      • ChurnZero
      • CJ Affiliate
      • CleverTap
      • ClickUp
      • Constant Contact
      • Courier
      • Criteo
      • Crowd.dev
      • Customer.io
      • Databricks
      • Delighted
      • Discord
      • Drift
      • Drip
      • Eagle Eye
      • Emarsys
      • Enterpret
      • Elasticsearch
      • Facebook Ads
      • Facebook Product Catalog
      • Freshdesk
      • Freshsales
      • Front
      • FullStory
      • Gainsight
      • GitHub
      • GitLab
      • Gladly
      • Google Ads
        • Customer Match Lists (Audiences)
        • Offline Conversions
      • Google AlloyDB
      • Google Analytics 4
      • Google BigQuery
      • Google Campaign Manager 360
      • Google Cloud Storage
      • Google Datastore
      • Google Display & Video 360
      • Google Drive
      • Google Search Ads 360
      • Google Sheets
      • Heap.io
      • Help Scout
      • HTTP Request
      • HubSpot
      • Impact
      • Insider
      • Insightly
      • Intercom
      • Iterable
      • Jira
      • Kafka
      • Kevel
      • Klaviyo
      • Kustomer
      • Labelbox
      • LaunchDarkly
      • LinkedIn
      • LiveIntent
      • Loops
      • Mailchimp
      • Mailchimp Transactional (Mandrill)
      • Mailgun
      • Marketo
      • Meilisearch
      • Microsoft Advertising
      • Microsoft Dynamics
      • Microsoft SQL Server
      • Microsoft Teams
      • Mixpanel
      • MoEngage
      • Mongo DB
      • mParticle
      • MySQL
      • NetSuite
      • Notion
      • OneSignal
      • Optimizely
      • Oracle Database
      • Oracle Eloqua
      • Oracle Fusion
      • Oracle Responsys
      • Orbit
      • Ortto
      • Outreach
      • Pardot
      • Partnerstack
      • Pendo
      • Pinterest
      • Pipedrive
      • Planhat
      • PostgreSQL
      • PostHog
      • Postscript
      • Productboard
      • Qualtrics
      • Radar
      • Reddit Ads
      • Rokt
      • RollWorks
      • Sailthru
      • Salesforce
      • Salesforce Commerce Cloud
      • Salesforce Marketing Cloud
      • Salesloft
      • Segment
      • SendGrid
      • Sense
      • SFTP
      • Shopify
      • Singular
      • Slack
      • Snapchat
      • Snowflake
      • Split
      • Sprig
      • Stripe
      • The Trade Desk
      • TikTok
      • Totango
      • Userflow
      • Userpilot
      • Vero Cloud
      • Vitally
      • Webhooks
      • Webflow
      • X Ads (formerly Twitter Ads)
      • Yahoo Ads (DSP)
      • Zendesk
      • Zoho CRM
      • Zuora
    • Custom & Partner Destinations
  • 📎Misc
    • Credits
    • Census Embedded
    • Data Storage
      • Census Store
        • Query Census Store from Snowflake
      • General Object Storage
      • Bring Your Own Bucket
        • Bring your own S3 Bucket
        • Bring your own GCS Bucket
        • Bring your own Azure Bucket
    • Developers
      • GitLink
      • Dataset API
      • Custom Destination API
      • Management API
    • Security & Privacy
      • Login & SSO Settings
      • Workspaces
      • Role-based Access Controls
      • Network Access Controls
      • SIEM Log Forwarding
      • Secure Storage of Customer Credentials
      • Digital Markets Act (DMA) Consent for Ad Platforms
    • Health and Usage Reporting
      • Workspace Homepage
      • Product Usage Dashboard
      • Observability Toolkit
      • Alerts
    • FAQs
Powered by GitBook
On this page
  • Getting started
  • Prerequisites
  • Step 1: Connect Zendesk
  • Step 2: Connect your data warehouse
  • Step 3: Create your model
  • Step 4: Create your first sync
  • Step 5: Confirm the synced data in Zendesk
  • Things to know about the Zendesk destination
  • Additional permissions required for syncs to the User object
  • Setting Organizations on the End User object
  • Setting the Tags property
  • Updating a dropdown property
  • Supported Objects and Sync Behaviors
  • Need help connecting to Zendesk?

Was this helpful?

  1. Destinations
  2. Available Destinations

Zendesk

This page describes how to use Census with Zendesk.

PreviousYahoo Ads (DSP)NextZoho CRM

Last updated 2 months ago

Was this helpful?

Getting started

In this guide, we will show you how to connect Zendesk to Census and create your first sync.

Prerequisites

  • Census account: If you don't have this already, .

  • Zendesk account

  • Have the proper credentials to access to your data source. See our docs for each supported data source for further information:

Step 1: Connect Zendesk

  1. Click New Destination.

  2. Select Zendesk from the dropdown list.

  3. Follow the Zendesk authentication flow and login with the desired account. The Zendesk connection within Census will have the permissions of the connected user account.

Your end state should look something like this: 👇

Step 2: Connect your data warehouse

The steps for connecting your data warehouse will depend on your technology. See the following guides:

After setting up your warehouse, your Destinations page should look something like this: 👇

Step 3: Create your model

When defining models, you'll write SQL queries to select the data you want to see in Zendesk. This can be as simple as selecting everything in a specific database table or as complex as creating new calculated values.

  1. From inside your Census account, navigate to the Models page.

  2. Enter a name for your model. You'll use this to select the model later.

  3. Enter your SQL query. If you want to test the query, use the Preview button.

  4. Click Save Model.

Step 4: Create your first sync

The sync will move data from your warehouse to Zendesk. In this step, you'll define how that will work.

  1. Under What data do you want to sync?, choose your data warehouse as the Connection and your model as the Source.

  2. Under Which properties should be updated?, select the fields you want to update by mapping a field in Zendesk to a column in your model. Choose a mapping setting:

    • Set overrides the existing value in Zendesk if the field is already populated.

    • Only If Empty does not set the value if the field is already populated.

    • For any properties that accept lists of values such as the Organization or Tags property, instead you'll see Replace. Replace mappings override any existing values or relationships for the property.

  3. Click Next. This will open the Confirm Details page where you can see a recap of your setup.

  4. If you want to start a sync immediately, set the Run a sync now? checkbox.

  5. Click Create Sync.

When configuring your sync, the page should look something like this: 👇

Step 5: Confirm the synced data in Zendesk

Once your sync is complete, it's time to check your data. Open Zendesk and check that the records updated correctly.

If everything went well, that's it! You've started syncing data from your warehouse to Zendesk! 🥳️

Things to know about the Zendesk destination

The way that Zendesk updates certain properties is complex.

Additional permissions required for syncs to the User object

Census utilizes Zendesk's Bulk User Import api endpoints to most efficiently sync your user data to Zendesk.

If data imports are not enabled a 403 Forbidden error is returned.

Setting Organizations on the End User object

In Zendesk, users (records in the End User object) can belong to multiple Organizations. When syncing the End User object, you can provide either a single External ID value or a list of values.

To link a user to multiple organizations, you'll need to format the list of External ID values as a JSON array of strings, for example:

["Team A", "Team B", "Team C"]

When syncing the Organizations property, Census will overwrite any existing relationships with the provided value. To maintain existing relationships, make sure that the corresponding External ID values are included in the array.

Setting the Tags property

Because of the way tags work in Zendesk, we don't recommend them for syncs. When possible, use dropdown and checkbox properties instead.

In Zendesk, the Ticket, End User, and Organization objects all include a Tags property. Tickets automatically pick up tags from related users and organizations. When configuring custom dropdown and checkbox fields in Zendesk, you can also configure those fields to add specific tags.

If you need to update the Tags property directly, keep these details in mind:

  • Tag names cannot contain spaces. Zendesk will treat spaces as separators between tags.

  • You can update the Tags property with multiple values by providing a JSON array, a space-separated list, or comma-separated list.

  • Syncing the Tags property will replace any existing tags on the records. To maintain existing tags, you'll need to make sure they appear in the list of tags you provide from your data source.

Updating a dropdown property

To update a dropdown property, the Zendesk API requires that you provide the API name of the dropdown option rather than the user-visible label.

By default, the API name is the user-visible label, but converted to lowercase and snake_case, for example, Paid User becomes paid_user. To update a dropdown property in this example, you'd provide the value paid_user.

If the Zendesk API names have not been modified, you can transform the label values using the following SQL:

lower(replace(column_name, ' ', '_'))

Supported Objects and Sync Behaviors

Census currently supports syncing to the following Zendesk objects:

Object Name

Supported?

Sync Keys

Behavior

End User

✅

External ID (recommended), Email

Update or Create, Update Only, Delete

Organization

✅

External ID (recommended), Name

Update or Create, Update Only, Delete

Ticket

✅

External ID

Update or Create, Update Only, Delete

Custom Objects

✅

External ID

Update or Create, Update Only

Ticket Comment

✅

Comment ID

Add

Warning

Delete syncs can result in data loss! Census recommends you backup this data if you're concerned about accidentally deleting the wrong records.

Need help connecting to Zendesk?

Log into Census and navigate to the page.

From inside your Census account, navigate to the page.

Under Where do you want to sync data to?, choose Zendesk as the Connection and an Object in Zendesk. (See .)

Under How should changes to the source be synced?, choose Update or Create. (See .)

Under How are source and destination records matched?, select a mapping key. We recommend mapping an internal ID property in your database to the External ID field in Zendesk. (See .)

Note that there are some gotchas with updating Zendesk data. Check out .

And if anything went wrong, contact the to get some help.

Bulk user imports are not enabled by default in Zendesk accounts. The account owner must contact to enable the imports.

Support for multiple organization relationships is an optional setting in Zendesk. See the for details.

Please note that Zendesk requires the Name property for the End User object. Feel free to check out Zendesk's documentation .

Learn more about all of our sync behaviors in our documentation.

if you want Census to support more Zendesk objects and/or behaviors.

You can send our at support@getcensus.com or start a conversation from the in-app chat.

🛫
start with a free trial
Azure Synapse
Databricks
Elasticsearch
Google BigQuery
Google Sheets
MySQL
Postgres
Redshift
Snowflake
SQL Server
Destinations
Databricks
Google BigQuery
Google Sheets
Postgres
Redshift
Snowflake
Syncs
Census support team
Zendesk Customer Support
Zendesk documentation
here
Syncs
Contact us
support team an email
Supported objects
Supported sync behaviors
Supported objects
Things to know about the Zendesk destination
Destinations page with Zendesk
Destinations page with data warehouse
Basic SQL query for a new model
Sync setup for Zendesk