Add contacts
Learn how to import existing contacts into Bird, or add new contacts manually.
Ways to add contacts to Bird
Bulk import new contacts from a CSV
You can manually import a large number of contacts into Bird by uploading a CSV file.
Access the Contacts Page
Go to Marketing > Audience > Contacts
You can also go to CRM > Contacts
On the Contacts page, Click on Manage data > Import from CSV

Format your CSV file
To ensure a smooth import, it's important to structure your CSV file correctly. We provide a model file in the CSV importer that you can use as a template to ensure that your file is properly formatted.

At a minimum, your CSV file must include one identifier for each contact, such as a phone number or email address. You can also include any other non-identifier attributes you want to add to your contacts.
For our system to recognize identifiers, the identifier column names must be written as follows:
phone
email
Example CSV file formatting
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.
Maria
Rodriguez
MX
+911234567891
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

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
5678
+911234567891
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.
Scroll through the columns to verify accuracy.
Once satisfied, click Continue.
After uploading, review the fields to ensure all data has been correctly mapped.

Map Columns
Under Map Columns section, you will see a mapping where you have your CSV file columns on left side mapped to Contact attributes to the right side.
Some of the mapping will be pre-filled for you, you could update it as needed. After updating, click on Save mapping.

You can click on gear icon next to any mapping to see advanced settings for the contact attribute such as
If you want to override the existing value or only set it if it is blank. By default, the import is set to override.

If you want the value to be required, which means the contact row will not get imported if the value if missing for a required attribute. By default, attributes are not required.

Provide further configuration
Under Configuration step, you can define additional settings such as Subscription, identifiers, lists as well as enabling automations.
If the CSV file you're uploading contains the subscription statuses of your contacts, you do not need to take any action during this step. Jump ahead to add the contacts you are importing to a list.
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.

If the contacts in your CSV are not subscribed to receive any marketing messages, your new contacts will still be imported, but you will not be able to send them marketing 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 to start impoting your contacts

You will be redirected to the Imports page, where you can monitor the progress and view details of all imports. You can also access this page from Contacts > Manage data > All Imports.

Create an individual contact
Creating a contact manually is useful when you only have a few contacts to add.
From Main navigation menu Click Marketing > Contacts or CRM > Contacts
Click Create contact.
Provide First name, Last Name, Display Name, Phone, Email or any additional attribute values to create a contact
Click Create contact.

Once the contact is created you can update it further from the Contacts page list view:
Updating Identifiers:
Under Identifiers section, you can add new identifiers by clicking on '+' icon. Select the identifier type from the drop-down menu (either phonenumber or emailaddress.) and provide a value. Toggle on "Make it an identifier"
To remove an identifier, you can delete it.
Updating Attributes:
Under Attributes section, You can fill out the attribute fields inline if you have the information:
First name
Last name
Avatar URL
Country
Locales
Gender
Any Custom attributes
Common Questions during Import
Why my list has less number of contacts than what was imported
The import view shows the number of all processed rows from your CSV file, however, if your file has duplicate identifiers such as phone or email, the total number of contacts created and added to your list will be less than expected.
Note that if you have common identifiers then your contact will be created as one and other identifiers will be added to it. For example, if you have 2 contacts with different email but same phone number, you will get only one contact created with 2 emails and 1 phone number.
Last updated
Was this helpful?