Getting Started With Group Creation

Uploading a Group lets you bring your contact list into GetThru from a CSV. This guide walks you through naming your group, uploading the file, mapping the required fields, and reviewing results so your list is ready for ThruText and ThruTalk campaigns.


Prefer a video? You can open our Groups video in our helpdesk, as a YouTube video, or download the file.


TABLE OF CONTENTS


Before uploading

Prepare your CSV so the upload runs smoothly and your contacts import correctly.

  • Use CSV format: The uploader accepts CSV files. Other file types (XLSX, Google Sheets) should be exported to CSV first.
  • Include a header row: Put your column names in the first row (for example, first_name, last_name, phone). 
  • Required Fields: Check that there is a column for each of the 3 Required Fields: first name, last name, and phone number. If any of the required columns are missing, create columns in your file with those headers and input values into those cells. If a contact is missing any of the three required data points, the contact will not be included in the group.
    • If a required value is missing for many contacts, add a placeholder so those rows are not excluded later. For example, if your file is missing some or all of your first name data, you can add a placeholder word such as "friend" for those contacts. Then, when using the first name field in your ThruText script, those contacts will be greeted as "friend" when you reference the contact's first name.
  • Meet size limits: Very large files can fail or time out. Keep groups to 150,000 contacts and CSV files to 45 MB. Remove unneeded columns or split the file into smaller parts if you are near a limit. You can add multiple groups to a single ThruTalk or ThruText campaign. See our guides, Advanced Targeting in ThruTalk and Advanced Targeting for ThruText, for steps. 
  • Mind concurrent uploads: Accounts can have a limited number of uploads processing at once. If you reach the limit, wait for one to finish before starting another.
  • Clean up formatting: Line breaks within cells and unusual characters can block or partially process uploads. Use find/replace to remove line breaks and non-ASCII characters before you upload.
  • Phone number basics: Numbers should be valid for the country you select. GetThru accepts standard punctuation (parentheses, dashes, plus signs), but letters in the phone field will cause errors. See Phone Number Formatting below for country specifics.


For additional context on how group size, file size, and concurrent uploads affect performance, see Groups Overview for Group Size and Upload Limits, and Group Index for Group Import Concurrent Limits. When your file meets these requirements, continue to Step 1: Name & Country.


Phone Number Formatting

GetThru recognizes common number characters (parentheses, dashes, plus signs). Letters in the phone field cause an error for that row.

Screenshot of an excel sheet. To the right of 6 entries is a green check mark. To the right of the bottom entry is a red x. That line contains a phone number with letters and numbers.

  • U.S. and Canada phone numbers should have 10 digits, or 11 digits when the country code (+1) is used (e.g. +1 234 567 8910)
  • UK phone numbers should have 10 digits, or 12 when the country code (+44) is added (e.g. +44 20 7123 4567)


How to upload a group

To start, click Create New Group from the left-side bar or the Upload New Group button on the admin dashboard, which will take you to the Group upload wizard.


Step 1: Name & Country

Give your group a name, pick the country of origin for your phone numbers, and then click the Next button.

Screenshot of a form is titled "Create a Group" on a white background. The first text input box shows the name of the group, with the words "Test Group" entered.  Beneath, a dropdown menu show country selection, currently displaying 'United States' as the available option.

Using a naming convention at group upload can save you time and effort during campaign creation.


Step 2: Upload CSV

Select the file you wish to upload by clicking Add a CSV to select a file from your computer or drag and drop a file into the upload box. 

A screenshot illustrating the second step of group creation on GetThru. Black text on a white background is positioned above and within a rectangle composed of dark grey dots, delineating the drag-and-drop zone for a CSV file upload. A dark green solid rectangle draws attention to the emphasized text 'Drag and drop a csv file to upload group or Add a CSV' within the interface.

Once you've added your file, you can see the number of detected rows or Clear the file if you want to upload something different. Ensure the wizard has completed assessing the number of rows before clicking the Next button to proceed.

A screenshot illustrating the second step of group creation on GetThru after selecting a CSV file for upload. Black text on a white background is positioned above and within a rectangle composed of dark grey dots, indicating the file upload area. Inside the rectangle, a file name is displayed alongside a button reading 'Clear' in dark pink text on a white background. A dark green solid-lined rectangle emphasizes the 'Clear' button. Additionally, at the bottom of the image, another dark green solid-lined rectangle highlights the text 'CSV has 4 rows'.

To import contacts from VAN, use External Contact Lists. Learn the basics in Getting Started with GetThru VAN Integrations, then follow the steps in the collection VAN Integration with ThruText — Importing Your List.


Common Upload Errors

  • File is too large: If it has more than 150,000 contacts or more than 45 MB, it can fail/time out. Remove extra columns or split the file.
  • Missing required fields: One of First Name, Last Name, or Phone is blank or unmapped.
  • Formatting issues: Line breaks or non-ASCII characters can block/partially process.
  • File name too long: Long file names can prevent uploads; shorten and retry.
  • If the upload still fails, contact support@getthru.io


Step 3: Required Fields

While uploading your CSV, the group upload wizard will detect which columns in your CSV should be associated with which fields and automatically map those columns. If a matching field is not found, you must use the dropdown to map all three required fields: First Name, Last Name, and Phone Number before continuing. Contacts missing any of these values are excluded from the group.

If two required values share one cell, use in your spreadsheet use Text to Columns to split them before uploading.


Step 4: Custom Fields

Map any custom fields you would like associated with your group. This step will list all of the custom fields on your account. The group upload wizard will detect likely matches between your CSV columns and custom fields. Adjust mappings using the dropdowns or select Ignore to skip a field.

Example: If "Select {CustomField} column" is left as the selection for a Custom Field, as shown for the "City" and "County" fields below, your custom fields will not be mapped.

Screenshot of a set of 3 drop down menus with dark grey text on a white background. The bottom drop-down shows "email" has been selected.

In the above image, the "email" field is mapped.


If you have a VAN Integration for your account and bring in the list via the external contact list feature, VAN ID will be automatically mapped correctly. If you are bringing in a VAN list from a CSV, you will also need to map your VAN IDs properly to ensure your data gets synced back.

NOTE - You must create your custom fields in your account before you can map them during the Group upload process. If the wizard skips from Required Fields to Review, no custom fields are created in your account. Review our guide, Custom Fields, for more details.


Step 5: Review & Create Group

Make sure everything looks good. You can return to any previous steps to make edits if you wish. Once you are satisfied that everything is set up how you want, click Create Group.

A screenshot displaying the sixth and final step of group creation within GetThru. At the top, 'Review Group' is presented in black text on a white background. Below, six rectangular boxes comprised of dark grey dots contain black text on a white background, showcasing details such as the group name, country, number of rows, and column header selections for First Name, Last Name, and Phone. Underneath the boxes, a dark magenta button with white text reads 'Create Group'.

After clicking Create Group, you'll be taken to Group Details. On that page, you can tell that a group is still Uploading by looking at the Details status indicator in the upper left of a group upload page:

A green Active status indicator means the group has finished validation and is ready to use in campaigns. Only groups that have finished uploading and are active can be selected for campaign targeting. See our guide for more information: Groups Details Page.


NOTE - Uploading should take less than 2 minutes to complete. If it takes longer than that or the numbers remain unvalidated, contact support@getthru.io.