Documentation / Product / Integrations / Zendesk

Zendesk: Export Users

Export Lytics audiences to behavioral data and scoring from Lytics to reach the most relevant users in your Zendesk Support account.

Integration Details

  • Implementation Type: Server-side.
  • Implementation Technique: REST API.
  • Frequency: Batch daily.
  • Resulting data: Your Zendesk user profiles will be updated with data from the fields you select in the work configuration. Lytics audience membership is also added as attributes on the Zendesk profiles.

This integration utilizes the Zendesk Support API to import user data. Once the import is started the job will:

  1. Scan the members currently in the audiences configured in Audiences to Include. If no audiences are configured, all Lytics users will be exported.
  2. Send the users in batches of 100 via the /api/v2/users/update_many.json endpoint.
  3. Configured fields are sent in the requests so that fields are updated in Zendesk on every run.
  4. If the steps for Including Lytics Audience Information below are followed, fields will be added corresponding to the audiences the user is a member of. If Audiences to Include is populated, only those configured audiences will be added. Otherwise, all of the user's audiences will be added.
  5. After all users are sent, the job will sleep for 24 hours and then repeat the process.


By default, Lytics exports the following fields to Zendesk: Export Users:

Lytics User FieldDescriptionZendesk FieldType
full_nameFull NameFull Namestring
first_nameFirst NameFirst Namestring
last_nameLast 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 audiences to export.
  7. Complete the configuration steps for your job. zendesk export config new
  8. If you wish to include audience information on the profiles exported to Zendesk, follow the instructions for Including Lytics Audience Information below.
  9. From the Full Name Field input, select the field that contains a user's full name.
  10. From the First Name Field input, select the field that contains a user's first name. Note that this is required if "Full Name Field" is not provided.
  11. From the Last Name Field input, select the field that contains a user's last name. Note that this is required if "Full Name Field" is not provided.
  12. From the Phone Number Field input, select the field that contains a user's phone number.
  13. From the Email Address Field input, select the field that contains a user's email address.
  14. From the Timezone Field input, select the field that contains a user's timezone.
  15. Click on the Show Advanced Options tab to expand the advanced configuration.
  16. From the Audiences to Include input, select the list of Lytics audiences you want to export to Zendesk. If this is left blank, all audiences that a user is a member of will be exported to Zendesk.
  17. From the Time of Day input, select the time of day to start export each day.
  18. From the Timezone input, select the timezone for the time of day.
  19. Click the Start Export button.

Including Lytics Audience Information

The first step in adding Lytics audience information to a Zendesk user is to create a new field in Zendesk to receive this information.

Start by clicking the gear Settings icon in Zendesk at the left of the screen. Then click on User Fields under the "Manage" heading, and click on the Text field type to create a new field:zendesk userfields

text user field correct fieldkey

Click Create Field and you're ready to get Lytics audience information into Zendesk.

Start a Zendesk Export like in the section above and use the audience selector to tell Lytics which lists you want to be visible in Zendesk.zendesk configure export After you click Start Export, your Zendesk users will be updated with the names of the Lytics audiences they belong to. Lytics will update this information daily, along with any other fields you selected in the configuration steps above.