Documentation / Product / Integrations / Zendesk

Zendesk Connect: Audience Export

Zendesk Connect manages proactive customer communication across channels, to deliver better customer experiences at scale. Export Lytics audiences to Zendesk Connect to reach your desired audiences on Zendesk Connect channels.

Integration Details

Users are updated in Zendesk according to the Identifier Field selected in the configuration. If the user does not yet exist in Zendesk, it will be created. User fields selected in the configuration will be added to the Zendesk profile as user attributes. An additional attribute will be added, which will include the slug of the Lytics audience being exported and the current membership status for the user in the audience, e.g. lytics_test_audience: true.

This integration utilizes the Zendesk Connect API to send user data. Once the export is started the job will:

  1. Enter events will be generated for all current members of the audience if the Existing Users option is selected during the Configuration.
  2. Every time a user enters or exits the audience, the export will send the user and its fields via the /v2/identify/batch endpoint. If the event is an enter, the audience slug attribute will be set to true. If the event is an exit, the audience slug attribute will be set to false.
  3. Mapped fields are updated in Zendesk every time an event for the user is processed.


By default, Lytics exports the following fields to Zendesk Connect.

Lytics User FieldDescriptionZendesk Connect FieldType
email optionalEmail Addressfirst_namestring
first_name optionalFirst Namefirst_namestring
last_name optionalLast Namelast_namestring


Follow these steps to set up and configure an export job for Zendesk in the Lytics platform. If you are new to creating jobs in Lytics, see the Jobs Dashboard documentation for more information

  1. Select Zendesk from the list of providers.
  2. Select the Export job type from the list.
  3. Select the Authorization you would like to use or create a new one.
  4. Enter a Label to identify this job you are creating in Lytics.
  5. (Optional) Enter a Description for further context on your job.
  6. Select the audience to export.
  7. Complete the configuration steps for your job. Zendesk Connect Export
  8. From the Identifier Field input, select the field that contains a user's identifier.
  9. (optional) From the Email Field input, select the field that contains a user's email.
  10. (optional) From the First Name Field input, select the field that contains a user's first name.
  11. (optional) From the Last Name Field input, select select the field that contains a user's last name.
  12. (optional) From the Fields to Export input, select a list of user fields to export.
  13. Select the Existing Users checkbox, select to immediately push users who currently exist in the selected Lytics audience. Deselecting will only push users as they leave or enter the audience.
  14. Click the Start Export button.