Bulk importing user data (legacy)

<div class="article-banners">
<div id="docs-wmp-link">
<a href="https://support.zendesk.com/hc/en-us/articles/5411234991258-plan" rel="noopener" target="_blank">What's my plan?</a>
</div>
<div class="article-banner" id="suite_all">
<table>
<tbody>
<tr>
<td>
<strong>All Suites</strong>
</td>
<td>Team, Growth, Professional, Enterprise, or Enterprise Plus</td>
</tr>
</tbody>
</table>
</div>
<div class="article-banner" id="support_all">
<table>
<tbody>
<tr>
<td>
<strong>Support</strong>
</td>
<td>Team, Professional, or Enterprise</td>
</tr>
</tbody>
</table>
</div>
</div>
<div id="docs-ai-summary">
<p id="docs-ai-summary-toggle">Verified AI summary <span id="up-triangle">◀</span><span id="down-triangle">▼</span></p>
<p id="docs-ai-summary-content">Admins can bulk import user data using a CSV file to add or update user information, including roles and organization memberships. Before importing, ensure data imports are enabled and organizations are imported first. Note limitations like a 2,000-row maximum per file and the inability to import certain data types. Consider your welcome email settings to manage notifications for new users.</p>
</div>
<div class="body">
<div class="note fastpath" id="zug_bulk_import_users_legacy__note_dxj_r4l_4hc">
<span class="fastpathtitle">Location: </span> <span class="ph">Admin Center &gt; Objects and rules &gt; Tools &gt; Data importer</span>
</div>
<p class="p">Zendesk recommends using the <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408893496218" target="_blank">data importer</a> to import user data instead of the legacy Bulk
actions page described in this article. However, if you prefer, you can still use the
Bulk actions page to import new or updated user information.</p>
<p class="p">Admins can add many users in a bulk import rather than adding users manually one at a
time. To do this, you create a comma-separated values (CSV) file that contains the
user's data. In addition to essential user data, such as email address and phone number,
you can also set user roles, define an agent's privileges, and add users to an
organization. You can use bulk import to either add new users or update existing ones.
Bulk import via a CSV file only works for Support users and roles. </p>
<p class="p">You must be an administrator to bulk import users and organizations.</p>
<div class="p">
<div class="note important" id="zug_bulk_import_users_legacy__note_exj_r4l_4hc">
<span class="importanttitle">Important:</span>
<ul class="ul" id="zug_bulk_import_users_legacy__ul_enz_vv1_5cc">
<li class="li">To protect the data in your Zendesk account, data imports are not enabled by
default. The account owner or an admin must contact <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408843597850" target="_blank">Zendesk Customer Support</a> to enable
data exports and access to the imports page.</li>
<li class="li">If you want to bulk import both users and organizations, you must <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408885980186" target="_blank">import organizations</a> first.</li>
</ul>
</div>
</div>
<div class="p">This article contains the following sections:<ul class="ul" id="zug_bulk_import_users_legacy__ul_cp1_mkx_2fc">
<li class="li"><a class="xref" href="#topic_py1_5kx_2fc">Considerations for bulk importing users (legacy)</a></li>
<li class="li"><a class="xref" href="#topic_svw_jdl_db">Creating the CSV user data file (legacy)</a></li>
<li class="li"><a class="xref" href="#topic_nly_lm1_5cc">Using a bulk actions import to import user data (legacy)</a></li>
</ul>
</div>
</div>
<div aria-labelledby="ariaid-title2" class="topic nested1" id="topic_py1_5kx_2fc">
<h2 class="title topictitle2" id="ariaid-title2">Considerations for bulk importing users (legacy)</h2>
<div class="body">
<p class="p">There are several limitations and considerations you should review before bulk
importing users.</p>
</div>
<div aria-labelledby="ariaid-title3" class="topic nested2" id="id_gm1_wmx_2fc">
<h3 class="title topictitle3" id="ariaid-title3">Limitations for bulk importing users and organizations (legacy)</h3>
<div class="body">
<p class="p">You can import a core set of data about users and organizations. For example, you can
import the data described in the table below. However, you can't import time zones, photos,
language preferences, and other data. To import data not listed in the table below, you must
use the Zendesk REST API instead. See <a class="xref" href="https://developer.zendesk.com/rest_api/docs/core/users" target="_blank">Importing
users with the Zendesk API</a> or <a class="xref" href="https://developer.zendesk.com/rest_api/docs/core/organizations#content" target="_blank">Importing organizations with the Zendesk API</a>.</p>
<ul class="ul" id="id_gm1_wmx_2fc__d9e74">
<li class="li">When using the Bulk actions pages, the import CSV data file can contain a maximum of
2,000 rows. That is, one header row and up to 1,999 rows of data.</li>
<li class="li">Don't include the same user or organization more than once within a CSV file. Doing so
can cause your import to fail.</li>
<li class="li">There's no guarantee that records are created or updated in the order they appear in the
CSV file.</li>
<li class="li">You can only import one CSV file at a time. Therefore, if you have more data than the
maximum number of rows supported for the CSV file, you must create separate files for each
batch and import them one after another. When you're not using the data importer, up to
two batches are queued and run in the background. If you want to import more than two
batches, you need to wait until the first batches are finished importing to add more.</li>
<li class="li">You cannot use bulk importing to import contact information from end-user Facebook or X
(formerly Twitter) accounts. Instead, use the Zendesk REST API. See <a class="xref" href="https://developer.zendesk.com/rest_api/docs/core/users" target="_blank">Importing
users with the Zendesk API</a>.</li>
</ul>
</div>
</div>
<div aria-labelledby="ariaid-title4" class="topic nested2" id="topic_mpt_fxg_g2c">
<h3 class="title topictitle3" id="ariaid-title4">How data is updated by the bulk actions import (legacy)</h3>
<div class="body">
<div class="p">When using the legacy bulk actions page to import user data, the following user
data is replaced:<ul class="ul" id="topic_mpt_fxg_g2c__ul_wnz_g21_zg">
<li class="li">name</li>
<li class="li">external_id</li>
<li class="li">role</li>
<li class="li">restriction</li>
<li class="li">organization</li>
<li class="li">custom fields</li>
<li class="li">tags (only when using the data
importer)</li>
</ul>
</div>
<div class="p">The following user data is appended (added to the existing data):<ul class="ul" id="topic_mpt_fxg_g2c__ul_jsv_p21_zg">
<li class="li">details</li>
<li class="li">notes</li>
<li class="li">tags</li>
<li class="li">phone (added as a secondary phone number)</li>
<li class="li">email (added as a secondary email address)</li>
</ul>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title5" class="topic nested2" id="topic_cvj_4rx_ji">
<h3 class="title topictitle3" id="ariaid-title5">Deciding whether to send an email to users imported in bulk (legacy)</h3>
<div class="body">
<p class="p">Before you perform a bulk import of users, it's important to <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408824350746" target="_blank">check your welcome email settings</a>.
When you add new users via a bulk import while Guide is enabled, each user
receives the welcome email message. The welcome email contains a link to verify
their email address, which prompts them to select a password and then sign in.
You can prevent the welcome email from being sent to these users.</p>
<p class="p"><strong class="ph b">To prevent the welcome email message being sent to users</strong></p>
<div class="p">
<ol class="ol" id="topic_cvj_4rx_ji__ol_bsp_qsx_jh">
<li class="li"><span class="ph">In <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4581766374554#topic_hfg_dyz_1hb" target="_blank">Admin Center</a>, click <img class="image" id="topic_cvj_4rx_ji__d10e773" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_people_icon.png">
<strong class="ph b">People</strong> in the sidebar, then select <strong class="ph b">Configuration &gt; End users</strong>.</span></li>
<li class="li">In the <strong class="ph b">User welcome email</strong> section, deselect <strong class="ph b">Also send a
verification email when a new user is created by an agent or
administrator</strong>.<p class="p"><img class="image img-screenshot" id="topic_cvj_4rx_ji__image_tn1_hqc_bq" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/bulk_import_disable_welcome_email.png"></p>
</li>
<li class="li">Click <strong class="ph b">Save</strong>.</li>
</ol>
</div>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title6" class="topic nested1" id="topic_svw_jdl_db">
<h2 class="title topictitle2" id="ariaid-title6">Creating the CSV user data file (legacy)</h2>
<div class="body">
<p class="p">When you create a list of users to import, you'll probably generate this list from
some other user management system, such as an employee database. Most of these
systems have some facility for creating a CSV export file. If you need to create the
list from scratch, you can use a program like Microsoft Excel or OpenOffice.org
Calc. </p>
<div class="p">Here are some important things to keep in mind when creating your file:<ul class="ul" id="topic_svw_jdl_db__ul_bkp_yh3_1w">
<li class="li">The file must be properly formatted CSV and saved using UTF-8 character
encoding.</li>
<li class="li">The first row of the CSV file is the header row, and you must include it in
the file. </li>
<li class="li">The header row must contain any required fields in the table below, plus any
other fields listed in the table below that you want to include. </li>
<li class="li">Included fields must appear in the header row in the order they are listed
below.</li>
<li class="li">If you are not importing data for a field, do not list it in the header row. </li>
<li class="li">Empty columns of data in the file will overwrite most existing data for that
user. For exceptions, see <a class="xref" href="#topic_mpt_fxg_g2c">How
data is updated by the bulk actions import</a>.</li>
<li class="li">Add line breaks to notes or multiline custom fields by pressing ALT+ENTER on
Windows or CTRL+OPTION+RETURN on a Mac.</li>
</ul>
</div>
<div class="p">
<div class="note" id="topic_svw_jdl_db__note_w2f_v4l_4hc">
<span class="notetitle">Note:</span> Microsoft Excel cannot save your file immediately. To
save your file, upload it to Google Sheets, re-download it, and then upload it
to Zendesk. You can also use Open Office to save the file. </div>
</div>
<p class="p">The following table lists the fields that you can include in the file. The name,
email, and restriction fields are all required when importing new users. When
existing users are updated via bulk import, only one unique identifier is required
(such as an email or external ID).</p>
<div class="p">
<div class="tablenoborder">
<table border="1" cellpadding="4" cellspacing="0" class="table" frame="border" id="topic_svw_jdl_db__table_rhi_mel_dc" rules="all" summary="">
<caption><span class="tablecap"><span class="table--title-label">Table 1. </span>User import data</span></caption>
<colgroup>
<col style="width:22.98850574712644%">
<col style="width:77.01149425287358%">
</colgroup>
<thead class="thead" style="text-align:left;">
<tr class="row">
<th class="entry nocellnorowborder" id="d90e330" style="vertical-align:top;">Field</th>
<th class="entry cell-norowborder" id="d90e333" style="vertical-align:top;">Description</th>
</tr>
</thead>
<tbody class="tbody">
<tr class="row">
<td class="entry nocellnorowborder" headers="d90e330" style="vertical-align:top;">name</td>
<td class="entry cell-norowborder" headers="d90e333" style="vertical-align:top;">
<strong class="ph b">Required for importing new users</strong>. User's full name.
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d90e330" style="vertical-align:top;">email</td>
<td class="entry cell-norowborder" headers="d90e333" style="vertical-align:top;">
<strong class="ph b">Required for importing new users</strong>. User's full email
address (someuser@mycompany.com). The email field accepts a
blank or empty value. If the email field is blank or empty, the
system still creates the user profile. </td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d90e330" style="vertical-align:top;">restriction</td>
<td class="entry cell-norowborder" headers="d90e333" style="vertical-align:top;">
<strong class="ph b">Required for importing new users</strong>. Restriction sets the
team member's or end user's privileges, the tickets they have
access to, etc. This is required to import new users when the
user's role is set to <em class="ph i">Agent</em>
<div class="p">On non-Enterprise plans, the following restriction values are
supported:<ul class="ul" id="topic_svw_jdl_db__ul_jfx_dpn_g2c">
<li class="li">
<strong class="ph b">assigned</strong>: The team member can access only
tickets assigned to them.</li>
<li class="li">
<strong class="ph b">groups</strong>: The team member can access only
tickets within their group(s). <strong class="ph b">Note</strong>: To add a
team member to a group, see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408821536794" target="_blank">Viewing and
managing team member group membership</a> or
use the <a class="xref" href="https://developer.zendesk.com/rest_api/docs/support/introduction" target="_blank">Support
API</a>.</li>
<li class="li">
<strong class="ph b">none</strong>: The user has no restrictions and can
access all tickets. </li>
<li class="li">
<strong class="ph b">organization</strong>: The user can access only
tickets requested by them or other users in their
organization</li>
<li class="li">
<strong class="ph b">requested</strong>: The user can access only their own
tickets. They must be listed as the ticket's
requester.</li>
<li class="li">(not data importer) <strong class="ph b">Light Agent</strong>: The user is
given the same <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408846501402#topic_p5d_zcr_pv" target="_blank">restrictions</a>
as a light agent.</li>
</ul>
</div>
Restriction values of "organization" and
"requested" can be assigned when the user's role is set to
"End-user". All others apply only to team members.
<div class="note" id="topic_svw_jdl_db__note_y2f_v4l_4hc">
<span class="notetitle">Note:</span> On Enterprise plans, agent roles
override the standard agent restrictions. This means that
you can't use any of the standard restrictions listed in the
table above to import or update an agent. You must specify
an agent role. If you accidentally use a role name that
doesn't exist in Support, the user's role defaults to Light
Agent.</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d90e330" style="vertical-align:top;">external_id</td>
<td class="entry cell-norowborder" headers="d90e333" style="vertical-align:top;">If you have an ID other than the user's email address (such
as an employee ID or customer reference number), you can include
it here. External IDs must be unique for each user, or data will
be overwritten.<p class="p">If you need to configure multiple email
addresses or phone numbers for a single user, you can do so
by creating multiple entries for the user in the CSV file
and using the same external_id column for all rows you want
associated with a single user. With the exception of the
additional email or phone numbers, the values in all other
columns should remain the same for each row.</p>
<p class="p">If any
external ID, email address, or phone number matches more
than one existing user, that row is rejected from the bulk
import.</p>
<div class="note" id="topic_svw_jdl_db__note_aff_v4l_4hc">
<span class="notetitle">Note:</span> If you import users
with the external_id field as their only identifier (meaning
you're not also including email address), you still need to
include the email field in the CSV file, with no data. For
example:<p class="p"><img class="image img-screenshot" id="topic_svw_jdl_db__image_evh_ql1_5cc" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/csv_file_email_blank.png" width="300"></p>
</div>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d90e330" style="vertical-align:top;">details</td>
<td class="entry cell-norowborder" headers="d90e333" style="vertical-align:top;">Detailed information concerning this user, such as an
address. This information is visible to team members only, not
to end users.</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d90e330" style="vertical-align:top;">notes</td>
<td class="entry cell-norowborder" headers="d90e333" style="vertical-align:top;">Notes concerning this user. Notes are visible to team members
only, not to end users.</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d90e330" style="vertical-align:top;">phone</td>
<td class="entry cell-norowborder" headers="d90e333" style="vertical-align:top;">The user's telephone numbers. Unique phone numbers are added
as direct lines. Phone numbers that already exist are added as
secondary lines. <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408823756570" target="_blank">To work with Zendesk</a>,
phone numbers should be formatted with the internationally
standardized<a class="xref" href="https://en.wikipedia.org/wiki/E.164" target="_blank"> E.164</a> format.
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d90e330" style="vertical-align:top;">shared_phone_number</td>
<td class="entry cell-norowborder" headers="d90e333" style="vertical-align:top;">If this is a shared phone number, set to "true". A shared
phone number cannot be used as a <a class="xref" href="https://developer.zendesk.com/api-reference/ticketing/users/user_identities/" target="_blank">user identity</a>.</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d90e330" style="vertical-align:top;">role</td>
<td class="entry cell-norowborder" headers="d90e333" style="vertical-align:top;">Case sensitive: <strong class="ph b">End-user</strong>, <strong class="ph b">Agent</strong>, or
<strong class="ph b">Admin</strong>. If you don't set a role, the user is set to
<strong class="ph b">End-user</strong>. </td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d90e330" style="vertical-align:top;">organization</td>
<td class="entry cell-norowborder" headers="d90e333" style="vertical-align:top;">The name of the organization that the user will be added to.
The organization must already exist, or the import will fail.
<p class="p">On Professional and Enterprise plans, you can add a user
to multiple organizations by separating the organization
names with a pipe character. For example:
<code class="ph codeph">Organization1|Organization2|Organization3</code></p>
<p class="p">A
user's default organization is set to the first organization
alphabetically. It isn't possible to set a different default
organization during a bulk import. However, the default
organization for a user can be adjusted manually or with the
<a class="xref" href="https://developer.zendesk.com/rest_api/docs/support/organization_memberships#set-membership-as-default" target="_blank">Support API - Set Membership as
Default</a> endpoint.</p>
</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d90e330" style="vertical-align:top;">tags</td>
<td class="entry cell-norowborder" headers="d90e333" style="vertical-align:top;">When user and organization tagging has been enabled for
Zendesk Support (see <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408881573658" target="_blank">Adding tags and users to
organizations</a>), you can add user tags. Separate each
tag with a comma.</td>
</tr>
<tr class="row">
<td class="entry nocellnorowborder" headers="d90e330" style="vertical-align:top;">brand</td>
<td class="entry cell-norowborder" headers="d90e333" style="vertical-align:top;">If the account has multiple brands, you can specify a brand
subdomain. The brand subdomain you specify determines the brand
of the welcome email sent to the user, as long as that brand is
active and has an enabled help center. If the brand subdomain
you specify is not active, doesn't have an enabled help center,
or doesn't exist, the column is ignored, and the welcome email
is sent using the default brand. Brand subdomains are
case-sensitive and must be an exact match to be imported.
<p class="p">Specify only the name of
the brand subdomain. For example, use <strong class="ph b">mydomain</strong> and
not <strong class="ph b">mydomain.zendesk.com</strong>.</p>
</td>
</tr>
<tr class="row">
<td class="entry row-nocellborder" headers="d90e330" style="vertical-align:top;">custom_fields.<em class="ph i">&lt;field key&gt;</em>
</td>
<td class="entry cellrowborder" headers="d90e333" style="vertical-align:top;">When you perform a bulk user import, you can import a custom
user field by specifying the <strong class="ph b">custom_fields.</strong> prefix and
the field key. <p class="p">For example, for the field
key <strong class="ph b">subscription_date</strong>, use the following to set
the imported values for this field.</p>
<div class="p">
<pre class="pre" id="topic_svw_jdl_db__pre_bff_v4l_4hc">custom_fields.subscription_date</pre>
</div>
<p class="p">Note that custom field keys are case-sensitive and must
be entered in lowercase letters. </p>
<p class="p">If you are importing
information into a checkbox, enter 'true' to have it checked
or 'false' to leave it unchecked. To set the value of
drop-down list options, use the tag you added when you
created the drop-down list. For custom date fields, use
either the YY/MM/DD or YYYY-MM-DD format.</p>
<div class="p">To locate
the key for a custom user field:<ul class="ul" id="topic_svw_jdl_db__ul_yry_spp_wqb">
<li class="li">
<span class="ph">In <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4581766374554#topic_hfg_dyz_1hb" target="_blank">Admin Center</a>, click <img class="image" id="topic_svw_jdl_db__d10e698" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_people_icon.png">
<strong class="ph b">People</strong> in the sidebar, then select <strong class="ph b">Configuration &gt; User fields</strong>.</span>Then click the name of the custom field. The field
key appears in the properties panel on the
right.</li>
</ul>
</div>
<p class="p">If a field value is not formatted correctly, the
import will fail, and you will receive an error report
specifying which records failed to save. </p>
<div class="note" id="topic_svw_jdl_db__note_cff_v4l_4hc">
<span class="notetitle">Note:</span> If the custom user field you're
importing is a <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4591924111770" target="_blank">lookup relationship
field</a>, enter the ID of the related object as the
value for this field. For example, for an organization,
enter the organization's ID; for a user, enter the user's
ID; for a custom object record, enter the record's ID. To
find an organization, user, or custom object record ID, you
can <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408886165402" target="_blank">export data from your
account</a> or use the <a class="xref" href="https://developer.zendesk.com/api-reference/ticketing/organizations/organizations/#list-organizations" target="_blank">Organizations API</a>,
<a class="xref" href="https://developer.zendesk.com/api-reference/ticketing/users/users/#list-users" target="_blank">Users API</a>, or
<a class="xref" href="https://developer.zendesk.com/api-reference/custom-data/custom-objects/custom_object_records/#list-custom-object-records" target="_blank">Custom Object Records
API</a>.</div>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
</div>
<div aria-labelledby="ariaid-title7" class="topic nested1" id="topic_nly_lm1_5cc">
<h2 class="title topictitle2" id="ariaid-title7">Using a bulk actions import to import user data (legacy)</h2>
<div class="body">
<p class="p">Although Zendesk recommends using the data importer, you can still use the Bulk
actions pages to import new and updated information for users.</p>
<div class="p">
<strong class="ph b">To import the CSV user data</strong><ol class="ol" id="topic_nly_lm1_5cc__ol_dpe_xjs_dc">
<li class="li"><span class="ph">In <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4581766374554#topic_hfg_dyz_1hb" target="_blank">Admin Center</a>, click <img class="image" id="topic_nly_lm1_5cc__d10e804" src="https://zen-marketing-documentation.s3.amazonaws.com/docs/en/ac_people_icon.png">
<strong class="ph b">People</strong> in the sidebar, then select <strong class="ph b">Bulk actions &gt; Import users</strong>.</span></li>
<li class="li">Select import options:<ul class="ul" id="topic_nly_lm1_5cc__ul_zsy_gks_dc">
<li class="li">
<p class="p"><strong class="ph b">Create new users</strong>: This is selected by default and cannot
be deselected. This is because users listed in the CSV file that
don't exist in your Zendesk account are always created.</p>
</li>
<li class="li">
<p class="p"><strong class="ph b">Update existing users</strong>: Select this import option if you
also want to modify data for existing users. </p>
<p class="p">An external_id or email address must be included in the CSV file
for each user so that they can be identified. Other than user
identification fields, only include the fields you want to
update in your CSV file. If you don't enter a value for a field
in your CSV file, that value is overwritten for the existing
user.</p>
<p class="p">If any external ID, email address, or phone number matches more
than one existing user, that row is rejected from the bulk
import.</p>
</li>
</ul>
<div class="note" id="topic_nly_lm1_5cc__note_dff_v4l_4hc">
<span class="notetitle">Note:</span> If you don't want to add new users, you
must use the <a class="xref" href="https://support.zendesk.com/hc/en-us/articles/4408893496218" target="_blank">data importer</a>. When using the
Bulk actions pages, if your CSV file contains information about new
users, they are always added, regardless of the import option you
select.</div>
</li>
<li class="li">(Optional) Select <strong class="ph b">Include external ID in CSV output file</strong>.<p class="p">When the
import process is complete, you will receive an email notification that
includes a link to a separate CSV import results file. Use this link to
download the file and view the results of your import. The file shows
the status of the user data that you attempted to import (Created,
Updated, Failed, Unchanged). If you select this option, the report
includes the email address or an external ID for each user that is
created or updated.</p>
<p class="p">If you don't select this option, external IDs
are excluded from the CSV import results file. Instead, only the user's
email address is listed for each user that is created or
updated.</p>
</li>
<li class="li">Click one of the following: <strong class="ph b">Choose File</strong> or <strong class="ph b">Let me paste in data
instead</strong>. </li>
<li class="li">Click <strong class="ph b">Import</strong>. </li>
</ol>
</div>
<p class="p">Your import is added to the queue, and the users are added to Zendesk Support when
the import process is complete. You'll receive an email when the import is complete. </p>
</div>
</div>
<script id="docs-schema-markup" type="application/ld+json">{
"@context": "https://schema.org",
"@type": "TechArticle",
"@id": "https://support.zendesk.com/hc/en-us/articles/10077720640026",
"url": "https://support.zendesk.com/hc/en-us/articles/10077720640026-Bulk-importing-user-data-legacy",
"headline": "Bulk importing user data (legacy)",
"description": "You can bulk import user data using a CSV file to add or update user information, including roles and organization memberships, with specific limitations and settings to manage notifications for new users.",
"articleSection": "Team members and groups",
"datePublished": "2025-12-18T15:10:49+00:00",
"dateModified": "2025-12-18T20:34:49+00:00",
"inLanguage": "en-US",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/10077720640026"
},
"author": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"publisher": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"isPartOf": {
"@type": "WebSite",
"name": "Zendesk Help",
"@id": "https://support.zendesk.com/hc/"
},
"about": {
"@type": "SoftwareApplication",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
}
}</script><script id="fast-path-script">
//<![CDATA[
const fast_path_style = document.createElement('style');
fast_path_style.innerHTML = `#article-body .fastpath{font-size:.9em;background-color:#f3f3f3;border:1px solid #d3d3d3;padding:10px 10px 8px;margin-bottom:16px}#article-body .fastpath::before{content:none!important}`;
document.head.appendChild(fast_path_style);
//]]>
</script><script id="ai-summary-script">
//<![CDATA[
const ai_summary_style = document.createElement('style');
ai_summary_style.innerHTML = `#styled-article-body{padding:0 0 0}#article-body #docs-ai-summary{background-color:#f3f3f3;border:1px solid #d3d3d3;padding:10px 10px 6px;margin-bottom:16px}#article-body #docs-ai-summary #docs-ai-summary-toggle{font-size:.9em;font-weight:700;margin-bottom:4px;cursor:pointer;display:flex;justify-content:space-between;align-items:center}#article-body #docs-ai-summary #docs-ai-summary-toggle #up-triangle{margin-left:auto;padding-right:10px;display:none}#article-body #docs-ai-summary #docs-ai-summary-toggle #down-triangle{margin-left:auto;padding-right:10px}#article-body #docs-ai-summary #docs-ai-summary-content{font-size:.9em;padding-left:25px;padding-right:25px;margin-bottom:12px}`;
document.head.appendChild(ai_summary_style);

const toggleAISummary = () => {
const summary = document.getElementById("docs-ai-summary-content");
const upTriangle = document.getElementById("up-triangle");
const downTriangle = document.getElementById("down-triangle");
if (summary.style.display === "none") {
summary.style.display = "block";
upTriangle.style.display = "none";
downTriangle.style.display = "inline";
} else {
summary.style.display = "none";
upTriangle.style.display = "inline";
downTriangle.style.display = "none";
}
};

document.getElementById("docs-ai-summary-toggle").addEventListener("click", toggleAISummary);
//]]>
</script>