Search documentation...

K

Zendesk

Deliver better support by making user events and attributes available inside Zendesk

Setup

Navigate to Admin Settings > Apps and integrations > Zendesk API and add a new API token for Hightouch. Make sure you enable Token access
Copy the API token and fill in the fields in Hightouch destination setup:
  • API token: token from Zendesk
  • Email: email used to login to Zendesk
  • Support URL: url for your Zendesk support site. make sure to include the https:// (ex: "https://hightouch.zendesk.com")

Syncing

Supported Objects

This integration support syncing the following objects:
  • Users
  • Organizations
  • Tickets
  • Custom Objects
  • Organization Memberships
If your Zendesk account has any custom objects, they will show up in the objects dropdown. Hightouch will distinguish the custom objects with a set prefix: (Custom).

Sync Modes

  • Upsert — pushes new objects to Zendesk and updates fields that change in your warehouse.
  • Update — updates particular fields on existing objects in Zendesk. It does not add new objects.
  • Insert — pushes new objects to Zendesk. It does not update any objects. (Only available for Organization Memberships)

Record Matching

Records can be matched from your source to your Zendesk objects by selecting a column in your results that matches the external ID, Zendesk ID, or email (contact only) of the Zendesk object.

Organization Memberships

Organization Memberships will behave differently. These objects will be matched by both the user_id and organization_id.
This field should be a combination of your user and organization columns that you will use in the mappings section. For example, if you are using the user's email and the organization's external_id, this field should be: "user_email:org_externalId". Do not edit/change either the user or organization field. Instead, you will need to remove the old row and create a new one to represent a new organization membership. Your model should look similar to below:

Field Mapping

You can sync columns from your source to Zendesk's default fields, as well as custom fields for your users, organizations and tickets objects. For more info on how to add custom fields to users, check out this guide.
For custom objects, you will be able to sync to any properties from your defined schema.

    Need help?

    Our team is relentlessly focused on your success. We're ready to jump on a call to help unblock you.

    • Connection issues with your data warehouse?
    • Confusing API responses from destination systems?
    • Unsupported destination objects or modes?
    • Help with complex SQL queries?

    or

    Feature Requests?

    If you see something that's missing from our app, let us know and we'll work with you to build it!

    We want to hear your suggestions for new sources, destinations, and other features that would help you activate your data.

On this page

SetupSyncingSupported ObjectsSync ModesRecord MatchingField Mapping

Was this page helpful?