Import your contacts into bird
Add or update contacts using a CSV file Import
Learn how to import and manage contacts in Bird. This guide covers importing CSV files, creating contact lists, managing subscription statuses, and adding individual contacts to existing lists.
Step by step guide
Importing contacts into Bird allows you to efficiently manage your audience by uploading contact information in bulk. This guide provides a step-by-step process to import contacts using a CSV file.
Access the Contacts page
Prepare your CSV File
Download the model file: In the CSV importer, download the provided model file to use as a template for proper formatting.

Ensure correct structure: Your CSV file must include at least one identifier for each contact, such as a phone number or email address. You can also include additional attributes like country, first name, last name etc.
If you format your CSV file like the one below, you will be able to successfully complete your import.
Note that not all fields are completed, but each contact has data in either the phone or email columns.
firstName | lastName | country | phone | |
---|---|---|---|---|
Jane | Smith | US | +911234567892 | jane-smith@sample.com |
Daan | Bakker | DE | daan-bakker@sample.com | |
Maria | UK | +911234567891 | ||
fatima-khan@sample.com |
Duplication and Merging:
Note that any duplicate rows will be ignored and no duplicate contacts will be created. Also, note that since both phone and email are considered as identifiers, if two rows have same email and different phone numbers, they will be merged into one contact. Same applies for two rows with same phone and different emails.
Adding attribute columns
You can also add values for any attributes in the csv upload by referencing to their name in the csv header. For example to add values for City attribute in your csv upload, add the highlighted section in the Name field (not display name) of the attribute after attribute. i.e attributes.city to the csv header.
You can find these names under Contacts > Data Management > Attributes
Note that the column name should be city in this case and NOT the display name City.

Below would be the csv format:
phone | country | city | birthday | |
---|---|---|---|---|
jane-smith@sample.com | +911234567891 | US | New York | 2025-07-25T12:00:00Z |
The format for uploading the date type attribute is YYYY-MM-DDTHH:MM:SSZ
Custom Identifiers
When uploading custom identifiers and communication attributes, you may not need email or phone as mandatory columns but custom identifier column will be mandatory. If your custom identifier attribute name is attributes.userId (not display name), then the column you should use should be identifier.userId.
For communication attributes for phone or email, you will need to use their name like any other attribute name columns. If your communication attribute is attributes.phone_number and attributes.email_address then the csv import will look like below
identifier.userId | phone_number | email_address | country | city |
---|---|---|---|---|
1234 | +911234567891 | a@b.com | US | New York |
Upload your CSV file
Drag and drop your prepared CSV file into the designated area, or click Browse to select the file from your device.
After uploading, review the fields to ensure all data has been correctly mapped.
Scroll through the columns to verify accuracy.
Once satisfied, click Continue.

Map Columns
Provide further configuration
Under Configuration step, you can define additional settings such as Subscription, identifiers, lists as well as enabling automations.
Identifier mapping: You can configure and select any identifiers you want to define and map it with the csv file column headers. You can also create new custom identifiers by typing in and selecting from the dropdown.

Adding to Lists: You can select one or more existing lists to add the contacts to. You can also create a new list and add to it.
Enable automations: You can configure if you want the automations like journeys and flows to be triggered automatically based on your import when contacts are created or updated. By default, the automations will trigger if they are based on contact creation or updates

Subscription Management: You can define for each platform how you want to set the Subscription attribute values of contacts getting imported. Please note that only Subscribed contacts will show up as estimated recipients in Campaigns.

Review and Import
Review all settings and mappings.
Click Continue to Import section
You can click on Run Audit to check your data for any errors before importing
If everything is good, click on Import

You will be redirected to the Imports tab, where you can monitor the progress and view details of all imports
