Ask or search…

Add contacts

Bulk import from CSV

You can manually import a large number of contacts into MessageBird by uploading a CSV file.

Format your CSV file

To ensure a smooth import, it's important to structure your CSV file correctly. We provide a demo 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.
+44 7123 456789
+52 55 1234 5678

Step-by-step instructions

  1. 1.
    On the side panel, click Contacts. You'll be taken to the Contacts directory.
  2. 2.
    Click the Actions button in the top right-hand corner, then click Import from CSV.
  3. 3.
    Drag and drop your formatted CSV into the upload window, or click Browse to locate a file from your device.
  4. 4.
    Next, review a sample from your CSV file. Check that the data matches the attributes, then click Next step.
  5. 5.
    Now you have the option to assign your contacts to a group. By default, contacts are auto-assigned to a group based on the date and time of the import. You can choose to add contacts to multiple groups or leave them unassigned. The following group actions are available:
    • To remove the auto-assigned group, uncheck the box.
    • To add contacts to an existing group, click Add group and select a group from the list.
    • To add contacts to a new group, click Add group, type a new group name, and then click Create 'Your New Group Name'. In the panel on the right, enter a description, then click Create.
  6. 6.
    Click Finish. Your import will start.

See the status of your CSV import

In the Jobs tab, you can view all of the imports that have been performed.
Imports are listed with the following information:
  • File name
  • Groups the contacts were added to
  • Contacts that were skipped, updated, or had errors
  • Total number of contacts uploaded
  • Timestamp of when the import was created
To view more detailed information about a specific import job, click on its corresponding entry. This will bring up a panel on the right-hand side, showing:
  • Start import time
  • End import time
  • Status (e.g., completed)

Create an individual contact

Creating a contact manually is useful when you only have a few contacts to add.
  1. 1.
    On the side panel, click Contacts, You'll be taken to the Contacts directory.
  2. 2.
    Click the Actions button in the top right-hand corner, then click Create contact.
  3. 3.
    Under "Identifier 1", select the identifier type from the drop-down menu (either phonenumber or emailaddress.
  4. 4.
    In the "Identifier value" field, enter the phone number or email address of the contact (e.g. [email protected]).
  5. 5.
    Optionally, you can add an additional identifier by clicking Add new identitifer.
  6. 6.
    In the "Display name" field, enter the contact's name.
  7. 7.
    Optionally, you can fill out the following attribute fields if you have the information:
    • First name
    • Last name
    • Avatar URL
    • Country
    • Locales
    • Gender
    • Custom attribute
  8. 8.
    Click Create contact.
Last modified 12d ago