Understanding Group Errors


An "Unknown Error" while attempting to upload your group into ThruText is usually caused by a file that is too big or because at least one of the required fields is missing.

Test Group ImageCommon Causes for Errors


1) The file is over 50,000 contacts or the actual file size is too large (greater than 7.5 MBs). 

If your file is over 50,000 contacts and/or has a ton of unnecessary columns it can cause the upload to time out and fail. This is particularly true if you export a file from something like TargetSmart or VAN.


Solution: Divide your group into lists of 50,000 and under while getting rid of any unnecessary columns of data. The required columns are the first name, last name, and phone number, and you can add any custom fields you need for ThruText such as the VAN ID or MyCampaign ID. This will help avoid the error.


2) You are missing one of the three required fields.

If the file size is less than 7.5 MB and you're still experiencing issues, this can most likely be attributed to an issue with one of the three required fields: First name, Last name, and Phone number.

This is usually caused by one of two things:

  • One of the three fields isn't mapped correctly 
  • One of the required fields is blank in one of the records in your file


Solution: Make sure first name, last name, and phone number are all filled out for each of the records in your file (if, for example, you don't have a last name for a record, you can put in a placeholder as long as it doesn't affect your script).


If you check these two things and it's still not working for you, please contact support@getthru.io and we will be happy to troubleshoot further for you.