How do I export a list of users?

<h2 id="h_01K20209ZVSN7V2EEZ7SXW4Z5E">Question</h2><p>I want to get a list of users in Zendesk Support. How can I download my user information to share outside of my account?</p><h2 id="h_01K20209ZVNSHR9A3ZZW4YEMZ4">Answer</h2><div id="interactive-tours"><div class="tab-content" id="tab-content-one">
<p><strong>Use basic data export</strong></p>
<p>Basic data export functionality is available to <a href="https://support.zendesk.com/hc/en-us/articles/4408886165402-Exporting-ticket-user-or-organization-data-from-your-account" target="_blank" rel="noopener noreferrer">these Support and Suite plans</a>. An account admin or custom role with export permissions can export a list of users in the <a href="https://support.zendesk.com/hc/en-us/articles/4408886165402-Exporting-data-to-a-JSON-CSV-or-XML-file" target="_blank" rel="noopener noreferrer">XML or JSON format</a>. Agents can only export users with the API. Download the file and manually filter it with software like Excel or Google Sheets.</p>
</div></div><div><div class="note">For Enterprise accounts, admins can use a granular permission to restrict CSV exports. If you use a custom role and cannot see the export options, ensure your admin has enabled the CSV Export permission for your role.</div></div><div id="interactive-tours_1">
<div class="tab-content" id="tab-content-two"><p>Verify <a href="https://support.zendesk.com/hc/en-us/articles/5411234991258-Checking-your-plan-type-or-add-ons" target="_blank" rel="noopener noreferrer">your plan</a> against <a href="https://support.zendesk.com/hc/en-us/articles/4408886165402-Exporting-ticket-user-or-organization-data-from-your-account" target="_blank" rel="noopener noreferrer">these plan requirements</a>. If your plan allows exports, yet you do not see the <strong>Reports</strong> option, contact <a href="https://support.zendesk.com/hc/en-us/articles/4408843597850-Contacting-Zendesk-customer-support" target="_blank" rel="noopener noreferrer">Zendesk Customer Support</a> to request the feature.</p></div>
<div class="tab-content" id="tab-content-three">
<p><strong>Use an add-on</strong></p>
<p>Accounts that purchased the <a href="https://support.zendesk.com/hc/en-us/articles/4408822480410-Managing-your-customer-lists" target="_blank" rel="noopener noreferrer">customer list add-on</a> can export user lists in a <a href="https://support.zendesk.com/hc/en-us/articles/4408845617306-Creating-and-using-customer-lists#topic_q3w_jrq_bm" target="_blank" rel="noopener noreferrer">CSV file</a>. This feature targets groups of users and includes the information of your choice in an export. Use the customer list add-on to export enhanced user list views, customer segmentation, or to schedule exports.</p>
<ul>
<li data-list-item-id="e573c39e5139f23ebbcdc05064b85c3f0">Enterprise Plans: Exporting CSV files from customer lists requires a custom role with the CSV Export permission enabled</li>
<li data-list-item-id="e5db3aa343dbab61f2622120f1ff021d1">Contributor Role: The Contributor role is a viewer-only role and does not support CSV exports. To allow an agent to export lists, they must be assigned to a Light Agent role or a custom role with export permissions.</li>
</ul>
</div>
<div class="tab-content" id="tab-content-four">
<p><strong>Use the API</strong></p>
<p>The REST API <a href="https://developer.zendesk.com/api-reference/ticketing/users/users/" target="_blank" rel="noopener noreferrer">Users endpoint</a> is available to all Zendesk accounts. The API gives you flexibility and control, but requires the assistance of someone with basic knowledge of code. If you have developer resources on your team, the API is a good option.</p>
<p><strong>Use the Marketplace</strong></p>
<p>Explore third-party alternatives to install from the <a href="https://www.zendesk.com/marketplace/apps/?query=export+user&amp;searchable_plan_pricings=Free" target="_blank" rel="noopener noreferrer">Zendesk Marketplace</a>, for example, the <strong>Advanced Search Plus</strong> app. In that app in <strong>Support</strong>, use the <code>*</code> search parameter to return all <strong>Users</strong>.</p>
</div>
</div><div class="note tip">This article is provided for instructional purposes only. Zendesk cannot provide support for third-party apps. Reach out to the email address of the developer under <strong>App details</strong>, from the app page in the Marketplace, or search for a solution online.</div><!-- AI knowledge DO NOT DELETE -->
<style>
.ai-only {
position: absolute !important;
width: 1px !important;
height: 1px !important;
padding: 0 !important;
margin: -1px !important;
overflow: hidden !important;
clip: rect(0, 0, 0, 0) !important;
white-space: nowrap !important;
border: 0 !important;
}
</style>
<div class="ai-only" aria-hidden="true">
<details>
<summary>THIS SECTION IS AI CONTENT. DON'T EDIT OR DELETE.</summary>
<h2 id="h_01KXGK7EFDFTG2YW1K2EK82Q0P">How do I export a list of users? How can I download my user information or customer data to share outside of my account? How do I extract my assignee or end user records?</h2>
<p>You can export a list of users by using the basic data export functionality, purchasing the customer list add-on, utilizing the REST API, or installing a third-party alternative app from the Zendesk Marketplace.</p>

<h2 id="h_01KXGK7EFD1XBJAK4XM70H5YH1">Can I download user data as a CSV file? Can agents export user lists? Can a read-only agent export customer information?</h2>
<p>Accounts with the customer list add-on can export user lists in a CSV file. Agents can only export users with the API. The Contributor role is a viewer-only role and does not support CSV exports; you must assign agents to a Light Agent role or a custom role with export permissions to allow exports.</p>

<h2 id="h_01KXGK7EFDPCS4GMWETH3BETVC">What formats does the basic data export support? What permissions do I need to export data? Why can I not see the data export options?</h2>
<p>The basic data export supports XML or JSON formats. An account admin or a custom role with export permissions can export the list. For Enterprise accounts, ensure your admin enables the <strong>CSV Export</strong> permission for your custom role. If your plan allows exports but you do not see the <strong>Reports</strong> option, contact Zendesk Customer Support.</p>

<h2 id="h_01KXGK7EFD0VMJ8M5B7W7698Z7">What is the customer list add-on? Why should I use the customer list add-on or paid plugin?</h2>
<p>The customer list add-on is a feature that targets groups of users and includes the information of your choice in a CSV export. Use this add-on to export enhanced user list views, perform customer segmentation, or schedule exports.</p>

<h2 id="h_01KXGK7EFECH2Y7Q0F968D4K9E">How do I use the API to export users? How do I use the Zendesk Marketplace to download customer data?</h2>
<ol>
<li>Access the REST API Users endpoint, which is available to all Zendesk accounts and requires basic knowledge of code.</li>
<li>Explore third-party alternatives to install from the Zendesk Marketplace, such as the Advanced Search Plus app.</li>
<li>Use the * search parameter in the app within Support to return all Users.</li>
</ol>
</details>
</div>