English (US)
  1. Zendesk help
  2. People
  3. People advice and troubleshooting

How do I export a list of users?

Katie Dougherty
  • Edited
Zendesk Digital Resources Team

Question

I want to get a list of users we have in Zendesk Support. How can I download my user information to share outside of my account?

Answer

The following options are available for you to export a list of users from your account:

Data export

Customer list add-on

API

Use basic data export

For Professional plans and above, accounts come with basic data export functionality. Any account admin or custom role agents with export permissions can export a list of users in an XML or JSON format. This option will export all user data, but once the file is downloaded, you can manually filter it with software like Excel or Google Sheets. 

Use an add-on

Accounts that have purchased the customer lists add-on can export their user list in a CSV file. This gives you the flexibility to target specific groups of users and to decide which information is included in an export.

Use the API

The Zendesk Rest API Users endpoint is also available in all Zendesk accounts but is a more technical solution. It gives you a lot of flexibility and control but usually requires the assistance of someone with basic knowledge of coding to implement effectively.  However, if you have developer resources on your team this would be a good option. 

Tip: Explore third-party alternatives that work for your use case in the Zendesk Marketplace.
Return to top

13 Comments

  • Jiri Kanicky

    Export users into CSV

    Export users into JSON in Zendesk -> Admin -> Reports

    Adjust JSON file to make it validated array:

    • add "," add the end of each line, but the last one
    • add "[" at the beginning of the file
    • add "]" at the end of the file

    JSON to CSV:

    I use VS Code with Python and Panda. Here is the simplest code you can use to transform JSON to CSV.

    import pandas as pd

    # read JSON file

    df = pd.read_json('./zd_user_all.json', orient='records')

    # create CSV file

    df.to_csv('zd_user.csv', index = None, header=True)

     

     

    1
  • Jonathan Morland

    Hello - for Option 3

    1. Accounts with the customer lists can export their user list in a CSV file.

    Could you detail the steps for this please?

    Thank you

    1
  • Josh
    Zendesk Customer Care
    Hi Jonathan!
     
    Thank you for messaging us. Customer list is a legacy add-on which is currently available for Suite plans. However, the steps in performing this is available here. 
    0
  • Tetiana Belevska

    As for option 4, you can find export and import apps on the Zendesk marketplace if you want to export your list of users in CSV. 

    Or there is an automated data migration app, called Help Desk Migration. They have their app on the Zendesk marketplace.

    1
  • Clive Carmock

    Seriously there is no download to CSV in Zendesk?   We have to mess with add ons, or JSON files and convert?  I see you have bulk import options.   The cynic in me would say exporting users (key activity in truing up user counts) is made hard to make it harder for admins to ensure licences are recovered.

    Is an export to CSV on the roadmap? if so when is it due?   if not - why not?

    4
  • Sarah H.

    Exactly. I have no idea why I have to be some sort of programmer just to export a list of emails for my customers who have booked tickets.  Its honestly ridiculous.

    3
  • Au Finh

    Sarah H. Agreed. Ideally, you should just be able to run a report and export. I usually recommend our clients to export from their reporting tool (Looker, Tableau, PowerBI, etc.) if they have access to one. That's probably the easiest and most robust workaround.

    0
  • Andrea Rochira

    It seems possible to export users in a CSV file; when requested, it is sent to your email address:

    However, it doesn't seem to include all the users... in my case it's listing only 492 users out of 46633... 

     

    0
  • Giuseppe
    Zendesk Customer Care

    Hi Andrea,

     

    CSV export is only applicable to tickets. Tested this out just now and I can confirm that only tickets are exported. Although, if you open the CSV file in a spreadsheet app, it could look like you are exporting a "Users" report because it lists ticket details including the ticket requesters. If you double-check the headers, it should look something like this:

    The 'Id' in this case refers to the ticket ID.

    More information about CSV Export:

    • CSV export: Exports ticket data in CSV format. Does not include deleted tickets, ticket comments, or ticket descriptions.

      With CSV export, if the amount of data being exported from a ticket is more than 1 MB, the ticket doesn’t export. It isn’t included in the resulting CSV file. However, typically, this never happens since CSV exports do not include ticket comments, which are usually the largest data component in a ticket.

      See Understanding which ticket data is in the CSV export for the ticket data included in CSV exports.

    Reference: Understanding the data export options

     

    0
  • Tom Wix

    Seriously - there is no way to get a report of customers (end users and their attributes) or organizations (customers and their attributes like external id, tags, etc) ?  

     

    There must be in Explore or worst case - a simple CSV dump ?

    1
  • Dane
    Zendesk Engineering
    Hi Tom,
     
    You can use the Full XML export option for users.
    0
  • Roman Sheydvasser

    Agent CSV export script:

    https://support.zendesk.com/hc/en-us/community/posts/4409217556506/comments/5071076068890

    0
  • Zak Khalid

    Really need to re-evaluate Zendesk as a product, If  I can't do a simple tasks as export users.

    1

Please sign in to leave a comment.

Powered by Zendesk