🔒 Who can do this: Admins only. |
You can add many companies and contacts at once by uploading a CSV file. This article covers how to upload a file, how rows without a company name are handled, and what happens when a row matches someone already in Firehose.
Uploading a File
Go to
Contactsand clickUpload.On the
Bulk Uploadpage, clickDownload CSV Templateif you want a template to fill in. You can also upload a file with different column names and map them in the next step.Drag your CSV file onto the page, or click to browse for it.
Choose whether to keep
Send intro drip to new contactsturned on (it's on by default). Newly created contacts are flagged for enrollment in your intro drip sequence. Contacts already in Firehose aren't affected. If your file includes custom-field values, they count toward intro drip matching for the contacts the import creates, so a new contact can be enrolled in an intro drip whose audience uses custom-field conditions. See Drip Campaigns.Click
Continue, then map each column in your file to a Firehose field.Review the duplicate counts and choose how to handle matches (see below).
Start the import. You'll see a status page with its progress and results.
Company Name and Website
By default, every row needs a company name and a website. A row without them is rejected.
If an admin has turned on Allow contacts without a company in CRM settings → Settings, the Company Name and Website columns don't have to be mapped:
A row with no company name and no website creates a contact with an individual company. The individual company takes the row's location, segment, and other company details that apply to a person, and gets a salesperson from the Salesperson column or your auto-assignment rules.
That row needs an email, a LinkedIn URL, or both a first and last name. Otherwise it's rejected with a message naming the details needed.
A row with a website but no company name is treated as a company that's missing its name, and is rejected.
A row with a company name but no website is rejected, as before.
Upload templates don't change.
Duplicates
Before the import runs, Firehose shows how many rows match existing companies and contacts. For each, choose what to do with the matches:
Ignore: leave the existing record as it is.Update — all fields: overwrite the existing record with every mapped column in the file.Update — selected fields: overwrite only the fields you pick. A field is offered only if your file has a column for it.
A blank cell in a mapped column clears that value on the existing record. Columns you didn't map are never written.
Rows with a company name are matched as before: by email across your workspace, otherwise by name within the same company.
How Rows Without a Company Are Matched
A row with no company name and no website matches an existing contact if any of these match, checked in this order:
Email address (ignoring capitalization), against any contact in your workspace
LinkedIn profile URL, against any contact in your workspace. Formatting differences such as www., country subdomains, trailing slashes, and tracking parameters are ignored.
First name, last name, and mobile phone, against contacts at individual companies only. Office phone isn't used.
First name and last name only, against contacts at individual companies. This rule is used only when the new contact has no email, LinkedIn URL, or mobile phone.
The same rules catch duplicate rows within one file. When a row matches:
No new contact or individual company is created. The contact stays at their current company and is updated or ignored, depending on your choice.
If the matched contact belongs to a regular company, only the contact's own fields are updated. The row's location, segment, and other company details are never written onto that company.
If the matched contact belongs to an individual company, that company counts as a duplicate company, and you can update its details.
Country (individuals only)andState (individuals only)can be selected on their own, with or without a postal code column.If a name-only row matches several people, it's rejected with a message asking for an email, LinkedIn URL, or mobile phone to tell them apart.
💡 Note: Uploading the same file again doesn't create duplicate contacts or individual companies. Each row is matched to the contact it created the first time, and is updated or ignored based on your choice. |
Checking the Results
File uploads are listed on the Imports tab in Discover, with their status and how many companies and contacts were added or already existed. Admins can click View on an import to see its detailed results.
