To create a contact list, upload records from the input file. You can also build contact lists using an Import template.

You can create a contact list with the following methods:

• Upload records in comma-separated values .csv or Excel file
• Use an Import template
• Use a File Specification template and upload records in a comma-separated, delimiter-separated, or fixed-length input file

If the contact list entry exists, see Append records to a contact list.

1. 1. Click Menu > Digital and Telephony > Outbound > List Management.
   2. Select the Contact Lists tab, and then click Create New.
   3. Type a unique name in the Contact List Name box. Names can contain spaces, numbers, and special characters, but must be unique.
   4. From the Division box, select a division or accept the default Home division.
      
      Note: If you do not assign a campaign to a custom division, it belongs to the Home division by default. See About Access Control and Divisions overview.
      
   5. To use a File Specification Template to upload contacts from a delimiter-separated file or a fixed-length format file, toggle Use File Specification Template to Yes. In the Select File Specification Template box, select a template to use for the contact list.
   6. In Upload contacts from a .csv or Excel file, click Browse. Select a .csv file and click Open. A list of sample rows appears.
   7. Follow this step if you are using an Import template to build your contact lists.
      Select your Import template.
      1. Toggle Use Import Template to Yes.
         
         Note: The Contact List Name box changes to List Name Prefix.
      2. In the Select Import Template box, select the template to use for this contact list.
      3. (Optional) Select a column from the Unique Identifier Column.
         
         What is a unique identifier?
         A unique identifier is useful if you will append this list with more data in the future. If you specify a unique identifier column, such as a customer ID or account number, the append process can match incoming data with existing contacts.
         Without a unique identifier, the entire row is the primary key. If you append a modified record, a subsequent upload appends that record as a new row, even if an existing row has the same identifier. With a unique identifier, the system replaces the existing record instead.
         Custom contact list ID columns cannot exceed 100 characters. A unique identifier can only include uppercase and lowercase letters, numbers, dashes (-), underscores (_), and asterisks (*). It cannot include spaces. 
         
         Note: A .csv file must not include any blank rows at the end of the data, which can cause an import failure.  
         
      4. To create your contact lists using the Import template, click Save.
         This is the last step for creating a contact list with an Import template. The system adds the new entry to the data grid of Contact Lists with progress and error indicators. While records are uploading, a progress indicator appears next to the contact list name.
         For more information on using an Import template to create your contact lists, see Contact List Builder.
   8. When you save a contact list, the leading and trailing white space is removed from the contact field of the contact list. If you do not want to remove the white space from your contact list, switch the Trim leading/trailing white space toggle to No.
   9. In Contact List Columns, select the appropriate columns. Contact lists can contain either or both phone numbers and email addresses. After you set one or the other, the placeholders update and show as optional.
      

      To select phone numbers
      

      1. Under Phone Columns, in the Column box, select a column containing phone numbers.
         
         Note: The maximum number of phone number columns allowed per list is 10.
         
      2. In the Type box, select the type of number, for example home, work or cell.
      3. This step is a prerequisite for configuring contactable time sets. If your contact list contains a column that contains the name of callable time entry in the contactable time set in Genesys Cloud, select that column from the Time Zone Name Column box.
         Note:  If you plan to use automatic time zone mapping, skip this step.
      4. To select another phone number column, repeat these steps.

      To select email addresses

      1. Under Email Columns, select a column containing email addresses.
         
         Note: The maximum number of email address columns allowed per list is 10.
         
      2. In the Type box, select the type of email address, for example personal or work.
      3. To select another email address column, repeat these steps.

      To select WhatsApp Phone IDs
      

      1. Under WhatsApp Columns, select a column containing WhatsApp Phone IDs.
      2. From the Type box, select the type of Phone ID, for example Personal or W ork.
      3. To select another WhatsApp Phone ID column, repeat these steps.
         
         
   10. If you want the system to determine compliant dialing times for the phone numbers in the contact list, set Automatic Time Zone Mapping to Yes.
       
       Notes:
       

       • Automatic time zone mapping is only supported for phone numbers; it is not supported for email addresses. Automatic time zone mapping is supported for: United States, Canadian, and Caribbean area codes, and United States postal codes. For more information, see Automatic time zone mapping overview.
       • To use the Automatic Time Zone Mapping feature from outside North America to dial North American phone numbers, the organization (Org) attempting to make the phone call must be located in one of the North American AWS regions.
   11. If you set Automatic Time Zone Mapping to Yes and your contact list has a column that contains the postal code, from the Zip Code Column box select ZIP. Postal codes can be blank. For best results with automatic time zone mapping, use both phone numbers and postal codes.
   12. To expand advanced options, click the caret next to Advanced.
       • (Optional) Select an entry from the Attempt Control list. Attempt controls restrict the number of calling attempts to a contact record or phone number on a specific day or in total.
         
         Note: Attempt control is supported only for phone numbers, not email addresses. For more information, see How to limit contact attempts.
       • (Optional) Select a column from the Unique Identifier Column.
         What is a unique identifier?
         A unique identifier is useful if you will append this list with more data in the future. If you specify a unique identifier column, such as a customer ID or account number, the append process can match incoming data with existing contacts.
         Without a unique identifier, the entire row is the primary key. If you append a modified record, a subsequent upload appends that record as a new row, even if an existing row has the same identifier. With a unique identifier, the system replaces the existing record instead.
         Custom contact list ID columns cannot exceed 100 characters and cannot contain special characters, such as a backslash. Compose a unique identifier from alphanumeric characters, excluding spaces, backslashes, and these special characters that don’t work with URLs:
         
         – . _ ~ : / ? # [ ] @ ! $ & ‘ ( ) * + , ; = 
         
         Note: A .csv file must not include any blank rows at the end of the data, which can cause an import failure.  
         
       • To preview dial specific contacts, even if the campaign is not running in preview mode, select a Preview Mode Column and one or more corresponding values. In the example below, a contact with WorkNumber equal to 3174134246 is always preview dialed.
         For example, set a VIP flag for a high-value contact to ensure that the system always preview dials a record and therefore never abandons it.
         
         Tip: Configure preview mode when you initially create the contact list. You cannot set up this feature later, while appending records.
         
         
         
       • If this contact list will be used in a campaign with Dynamic Queueing sorting, you must specify the data type for the column to be sorted by, when running your campaign. Consider setting up potential sort columns for your future campaigns.
         Under Column Data Type Specifications, configure the settings for the selected column.
         

         Data Type	Properties
         Numeric	Min Max Specify the minimum and maximum acceptable values for the selected column.
         Text	Max Length Specify the maximum character length for the selected column. The maximum length of all text columns combined cannot be greater than 750 characters.
         Timestamp	Requires the standard ISO format YYYY-MM-dd'T'HH:mm'Z' Acceptable formats are:: 2017-07-15T15:45Z for minutes precision 2017-07-15T15:00Z for hour precision 2017-07-15T00:00Z for day precision Note: This value corresponds to the MySQL TIMESTAMP column type. This means that you cannot enter dates earlier than 1970-01-01 or later than 2038-01-19.
         DateTime	Requires the standard ISO format YYYY-MM-dd'T'HH:mm'Z' Acceptable formats are:: 2017-07-15T15:45Z for minutes precision 2017-07-15T15:00Z for hour precision 2017-07-15T00:00Z for day precision Note: This value corresponds to the MySQL DATETIME column type. This means that it accepts any valid ISO 8601 date.

         Notes:
         

         • If you save a contact list with column data type specifications, you cannot go back and edit the column data type specifications. If changes are required for the column data type specifications, you have to create a new contact list.
         • If you save a contact list without data type specifications, you can go back and create new column specifications.
   13. (Optional) Under Retention Configuration, you can specify contact list-level and contact-level retention policy for the contact list. These settings are optional. If you use a template to create the contact list, and the template contains retention configurations, you can only change the Contact-level Retention Import Columns.
       • Under Contact List-level Retention Configuration, you can select the time zone in which retention is determined and the type of retention. Choose from the following retention types.
         • Never: The contact lists are never automatically deleted. This results in the same behavior as the default, empty setting.
         • Default Retention Days: The contact lists are deleted after a specific number of days. If you select this option, specify the number of days in the Default Retention Days text box. The value must be between 1 and 360. The days count down from the time of creation, regardless of when you access the setting.
         • Today: The contact lists are deleted at 12:00AM (midnight) in the configured time zone.
         If you set a value for Retention Type other than Never, the expiration date of the contact list appears. The expiration date always appears in the UTC time zone.
         After you save the contact list, you cannot change the time zone setting.
         By default, the values in Time Zone and Retention Type are the same as the organization-level settings. These settings overrides the organization-level settings. You can set contact list-level retention even if there are no organization-level settings. For more information, see Outbound settings.
       • Under Contact-level Retention Import Columns, you can specify the retention type, retention days, and expiration date columns from the input file in the contact list.
         The contact-level settings appear when you import a file.
         The values in these columns always appear in the UTC time zone.
   14. Click Save. The system adds the new entry to the data grid of Contact Lists with progress and error indicators. While records are uploading, a progress indicator appears next to the contact list name. 
       When the upload completes, a message appears.