Deliver better support by making user events and attributes available inside Zendesk
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
This integration support syncing the following objects:
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).
- Upsert: pushes new objects to Zendesk and updates fields that change in your warehouse.
- Update: updates particular fields on existing objects in Zendesk. It doesn't add new objects.
- Insert: pushes new objects to Zendesk. It doesn't update any objects. (Only available for
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 will behave differently. These objects will be matched by both the
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
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:
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, refer to the Zendesk docs.
For custom objects, you will be able to sync to any properties from your defined schema.
Search batch size
Zendesk's search API can return up to 1000 results, but by default Hightouch only searches for 100 records at a time. You can increase this amount up to 500 for a faster sync.
However, increasing the batch size can increase the risk of receiving a '414 - Long URI` error. Conversely, if you are experiencing these errors with the default batch size setting, you can lower the batch size to avoid the errors.