Connecting Contacts from App Integrations

This article demonstrates how to add contacts to CommPeak SMS platform from your integrated application using an example of HubSpot CRM.

  1. In your CommPeak SMS account, navigate to Contacts > Contact Lists.

  2. Click Add List in the top right.

    Screenshot of the **Contacts > Contact Lists** page

    Contacts > Contact Lists page

  3. You will see a pop-up window. Select an option to import from application integration.

    Screenshot of the **Add New List** page: **List details** step

    Add New List page: List details step

  4. Enter the list name and an informative description. Then click Save & Next.

  5. Select HubSpot in the Integration dropdown list.

  6. Select a connection you created in Integrations when installing the application. Then click Save & Next.

    Screenshot of the **Add New List** page:**Integration setting** step

    Add New List page:Integration setting step

  7. Select which contact data you would like to import from HubSpot. Start typing in the box to locate the needed field quickly.

    Screenshot of the **Add New List** page: selecting contact fields

    Add New List page: selecting contact fields

  8. In Filter, select a contact list you previously created in HubSpot.

    Screenshot of the **Add New List** page: setting data filters

    Add New List page: setting data filters

  9. Click Save & Preview.

  10. Map contact details with available contact fields as necessary.

    Screenshot of the **Imported Contacts Preview** page

    Imported Contacts Preview page

  11. Click Import Contacts.

  12. View the list summary and click Continue.

    Screenshot of the importing contacts notification

    Importing contacts notification

The new list appears at the top and will take some time to process.

Screenshot of the **Contact Lists** page with the added contact lists

Contact Lists page with the added contact lists

Refer to the following table for column descriptions in Contact Lists.

ColumnDescription
List NameClick the title to open a side panel, which you can also load when clicking the information icon in Actions. It contains details about the list, parse status of contacts, and campaigns where it has been used.
SourceCSV or app integration
ProgressThe Progress column shows the contact import progress.
If a progress bar is displayed, the list is still being imported.
The _Ready _status means that importing is complete.
ContactsThe Contacts column shows the total number of contacts in the list.
You can see how many of them are parsed or failed by clicking the information icon in Actions.
Creation AtDate and time in UTC when the list was uploaded
ActionsThis column provides additional controls.

Actions

You can view more information from the Actions column and delete or download contact lists.

Screenshot of the **Actions **options

Actions options

Click the Actions column's information icon to view your contact list details. On the List Info tab, you can see how many contact details are added (parsed) or failed due to invalid or not mobile phone numbers.

Screenshot of the **Actions > List Info** tab

Actions > List Info tab

If you want more information about the list and its usage in campaigns, go to the Campaigns Info tab.

Screenshot of the **Campaigns Info** tab

Campaigns Info tab

To delete the list, click Delete in Actions.

To save the list as a .csv file, click Download in Actions. It will take some time to prepare downloadable files for large lists. They will appear in Tasks when ready. If you would like more information, please take a look at the Tasks article.