Zendesk
This page describes how to use Census with Zendesk.

๐Ÿƒโ€โ™€๏ธ Getting started

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

Prerequisites

Step 1: Connect Zendesk

  1. 1.
    Log into Census and navigate to the Connections page.
  2. 2.
    Click Add Service.
  3. 3.
    Select Zendesk from the dropdown list.
  4. 4.
    Follow the Zendesk authentication flow.
Your end state should look something like this: ๐Ÿ‘‡
Connections page with Zendesk

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 Connections page should look something like this: ๐Ÿ‘‡
Connections page with data warehouse

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. 1.
    From inside your Census account, navigate to the Models page.
  2. 2.
    Enter a name for your model. You'll use this to select the model later.
  3. 3.
    Enter your SQL query. If you want to test the query, use the Preview button.
  4. 4.
    Click Save Model.
Basic SQL query for a new 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. 1.
    From inside your Census account, navigate to the Syncs page.
  2. 2.
    Under What data do you want to sync?, choose your data warehouse as the Connection and your model as the Source.
  3. 3.
    Under Where do you want to sync data to?, choose Zendesk as the Connection and an Object in Zendesk. (See Supported objects.)
  4. 4.
    Under How should changes to the source be synced?, choose Update or Create. (See Supported sync behaviors.)
  5. 5.
    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 Supported objects.)
  6. 6.
    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.
    Note that there are some gotchas with updating Zendesk data. Check out Things to know about the Zendesk connector.
  7. 7.
    Click Next. This will open the Confirm Details page where you can see a recap of your setup.
  8. 8.
    If you want to start a sync immediately, set the Run a sync now? checkbox.
  9. 9.
    Click Create Sync.
When configuring your sync, the page should look something like this: ๐Ÿ‘‡
Sync setup for Zendesk

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! ๐Ÿฅณ๏ธโ€‹
And if anything went wrong, contact the Census support team to get some help.

๐Ÿ’ก Things to know about the Zendesk connector

The way that Zendesk updates certain properties is complex.

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.
Support for multiple organization relationships is an optional setting in Zendesk. See the Zendesk documentation for details.
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:
1
["Team A", "Team B", "Team C"]
Copied!
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:
1
lower(replace(column_name, ' ', '_'))
Copied!

๐Ÿ—„ Supported objects

Census currently supports syncing to the following Zendesk objects:
Object Name
Supported
Identifiers
End User
โœ…
External ID (recommended), Email
Organization
โœ…
External ID (recommended), Name
Ticket
โœ…
External ID
Custom Objects
โœ…
External ID
โ€‹Let us know if you want Census to support additional objects for Zendesk.

๐Ÿ”„ Supported sync behaviors

Behavior
Supported
Objects
Update or Create
โœ…
All
Learn more about all of our sync behaviors on our Core Concepts page.
โ€‹Let us know if you want Census to support more sync behaviors for Zendesk.

๐Ÿš‘ Need help connecting to Zendesk?

You can send our support team an email at [email protected] or start a conversation from the in-app chat.
Last modified 2mo ago