Import New Users into HubSpot with a CSV File

Learning how to import new users into HubSpot with a CSV file will save you time, reduce manual data entry, and help you onboard teams at scale. This step-by-step guide walks you through how to prepare your CSV, run the import, and manage permissions so your account stays organized and secure.

The process is straightforward once you understand the required columns, the role of teams and permissions, and how invitation emails are handled. Follow the sections below to complete a clean, accurate upload the first time.

Before You Import Users into HubSpot

Before you import a list of people as users, confirm that your account and file are ready. Proper preparation prevents failed imports and incorrect access levels.

Check your HubSpot user permissions

The person running the import must already be a user with the correct permissions. Typically, you should have:

• Super admin permissions, or
• Specific permissions to add and edit users.

If your access is limited, ask an existing super admin to adjust your permissions or complete the import for you.

Understand what a HubSpot user import does

Importing users with a CSV adds people as users to your account, not as contacts for marketing. Each row becomes a user record with its own login, role, and level of access.

During the process, you can:

• Add completely new users to your account.
• Assign users to teams.
• Define whether users receive invitation emails immediately.
• Set permission templates where available in your subscription.

If you want to upload people as marketing or sales contacts instead of account users, use the standard contacts import flow instead.

Prepare Your CSV File for HubSpot

A clean CSV file is critical for a smooth import. You must include specific columns and format values correctly so the platform can map them to user properties.

Required columns for a HubSpot user CSV

At minimum, add these columns as your CSV headers:

• Email (required): the email address will be the username.
• First Name (optional but recommended).
• Last Name (optional but recommended).
• Send Welcome Email (optional): controls whether the system sends an invite.

The email column is mandatory and must contain unique, valid email addresses. If an email is already associated with a user, the import may fail or skip that row.

Optional user fields supported by HubSpot

Depending on your subscription and settings, you may include additional columns, for example:

• Role or Permission Set (if permission templates exist).
• Team: for assigning the user to a team.
• Language or Time Zone: if supported for user records.

Check your account documentation to verify property names that are available for user imports.

Formatting rules for your HubSpot CSV

• Save the file as .csv, not .xlsx or .xls.
• Use one row per user.
• Avoid extra blank rows or merged cells.
• Make sure column headers are in the first row only.

Keeping your file structure simple ensures that the import wizard can accurately detect and map your fields.

How to Import Users into HubSpot with a CSV

With your CSV ready, you can start the import inside your account. The main steps are uploading the file, mapping the fields, reviewing the preview, and confirming.

Step 1: Open the user import tool in HubSpot

1. Log in to your account.
2. Navigate to your settings area.
3. Go to the section for Users & Teams.
4. Look for the option to Import users or add multiple users at once.

The wording may vary slightly depending on your subscription tier and interface updates, but the function to import from a file will be visible in the users management area.

Step 2: Upload your CSV file

1. Click the option to import from file.
2. Select CSV as the file type.
3. Choose the prepared CSV from your computer.
4. Confirm and proceed to the mapping screen.

The system will scan your headers and attempt to match them to user properties automatically.

Step 3: Map fields to HubSpot user properties

On the mapping screen, verify that each column from your file is correctly matched to an internal property.

• Confirm that the Email column maps to the user email property.
• Check that First Name and Last Name columns map correctly.
• Map any additional columns such as team or permission sets if available.

If a field is not recognized, manually select the correct property from the dropdown. You can also ignore unnecessary columns by setting them to not import.

Step 4: Configure invitation emails

During the import, you can decide whether new users receive a welcome email. The exact options depend on your file setup:

• If you included a Send Welcome Email column in your CSV, values like “TRUE” or “YES” may trigger an invite.
• If not, you may see a global option to send invitations to all imported users.

Review the invitation setting carefully so you do not accidentally send emails before you are ready.

Step 5: Review and start the HubSpot import

Before you finalize the import, review the summary screen:

• Check the number of rows detected.
• Confirm how many new users will be created.
• Look for any alerts about missing emails or invalid data.

When everything looks correct, click to start the import. Large files may take a few minutes to process.

After the HubSpot User Import Completes

Once the process finishes, you can verify results, correct any issues, and adjust permission levels for specific users.

Check imported users in your HubSpot account

1. Navigate back to the Users & Teams settings area.
2. Filter or sort by Date created to see recent additions.
3. Confirm that all expected users appear with correct names and email addresses.

If some rows failed, you may see an import error report explaining the reason, such as a duplicate email or missing required field.

Assign teams and permissions after import

Even when you assign teams during the CSV upload, you may still want to refine access controls user by user.

• Edit individual user records to adjust team membership.
• Apply or change permission sets based on role.
• Deactivate any test or incorrect users that were added.

Keeping your user base and access levels organized is essential for data security and compliance.

Resend or manage HubSpot invitations

If someone did not receive or lost their welcome email, you can resend the invitation from their user record. In some cases, administrators may also choose to:

• Update the user’s email address before resending.
• Disable automatic invitations during the next import and send them later.

This flexibility lets you control how and when people gain access to your tools.

Common Issues with HubSpot User CSV Imports

When problems occur, they are usually related to formatting, permissions, or duplicate data. Understanding these issues helps you troubleshoot quickly.

Typical errors and how to fix them

• Missing required email: Add a valid email address and re-import the affected rows.
• Duplicate users: Remove rows with emails that already exist in your account, or update the existing user instead of importing.
• Incorrect mapping: Re-run the import and carefully adjust the field mapping step.
• File format problems: Re-save as plain CSV and remove extra tabs or sheets.

If an import fails repeatedly, download any available error report and compare the problematic rows with the requirements.

Learn more from the official HubSpot documentation

For the most current rules and supported fields, review the official documentation here: How to import new users with a CSV file. Interface labels and supported user properties can evolve over time, so it is helpful to cross-check with the latest guide.

Optimize Your HubSpot Setup After Import

Once your users are in place, you can focus on configuration, automation, and adoption so the platform supports your entire team effectively.

Next steps for organizing your HubSpot account

• Structure clear teams for sales, marketing, service, and operations.
• Align permission sets with job roles to minimize risk.
• Configure audit-friendly rules for who can delete or export data.
• Set up training or onboarding sequences for new users.

Thoughtful planning upfront leads to higher adoption and fewer support issues later.

Get expert help with HubSpot implementation

If you need assistance designing a scalable user structure, building automation, or improving data governance, consider working with specialists. For example, Consultevo provides consulting services that can help you align your platform, teams, and processes for long-term success.

By following the steps above and keeping your CSV files clean, you can reliably import new users into your account, maintain accurate access levels, and keep your organization running smoothly.

Need Help With Hubspot?

If you want expert help building, automating, or scaling your Hubspot , work with ConsultEvo, a team who has a decade of Hubspot experience.

Scale Hubspot

“`