You are using an unsupported browser. Please update your browser to the latest version on or before July 31, 2020.
Home > Contacts > Management > Create and Manage Contacts
Create and Manage Contacts
print icon

A contact is an individual whose interaction with your business has prompted the creation of a profile in your Privy account. The information stored in these records empowers you to create more focused displays via audience targeting and enables you to send eligible recipients marketing or sales communications.


There are multiple ways to create contacts in Privy:

  • New visitors submit a Privy form with their email addresses or phone numbers. It automatically creates a contact profile for the visitor with a unique email address or phone number. 
  • External contact data in a spreadsheet (CSV) imported into Privy. 
  • External contact data from an integrated tool (Linked Account) imported into Privy. 
  • Manually creating a contact via the Contacts dashboard in Privy. 


Contacts and their associated profile information are available for export following their creation. 

Import via spreadsheet

Formatting your data

To correctly import a contacts file, you must have your data structured appropriately. An example file is available for download here. Please ensure your import meets the following criteria:

  • The file must use the CSV format. 
  • The file must include an email address column.
  • The first row of the file must contain column headers. These headers are not case-sensitive and match the imported values with customer attributes (fields) in Privy. 
  • If you are importing some mailable and some non-mailable (unsubscribed) contacts, you should separate your contacts into two files—one for subscribed and one for unsubscribed contacts. 

Once your file is ready, please also note that: 

  • Contacts are only considered mailable if they are identified as such during the import process and are also subsequently approved by the Privy Compliance team.
  • Imported phone numbers will not be eligible for Privy text messages. Only phone numbers collected via Privy with the text opt-in box checked will be eligible to receive Privy texts.
  • If you upload a file that includes existing email addresses, the associated contact profile will update to include the most recent value(s) and any additional fields.
  • Every contact included in the file does not need a value for a custom field.

Upload and match your data

To upload your properly formatted contacts file: 

  • In your Privy account, select Contacts >All Contacts from the main navigation. 
  • On the Contacts dashboard, select the Add Contacts option. 
  • Select the CSV Upload option from the dropdown menu.
  • Click Choose File to locate the CSV file on your computer. Once you have selected the file, click Next in the lower right corner. 

  • On the Match your Columns page, you will match the file's column headers with customer attributes (fields) in Privy. Use the dropdown menus to select an existing attribute or click Create New Field to create a new custom field to store the information. After matching all of the fields and identifying one of them as the required email field, click Next 

  • On the Choose Status page, select whether the file is a list of Subscribed or Unsubscribed contacts. Confirm your selection by typing out the status and then click Next.
  • On the Tag page, you can apply a tag to every contact in the file to make filtering or segmenting for these specific contacts easier in the future. Tags are optional
  • Lastly, review and confirm your file upload by clicking Submit.

After submitting the import, your contacts will begin populating your account following a review by the Privy Compliance Team. That said, please keep in mind that depending on the size of the import file, this process can take a while. The review status of the import is available in the Import section of your account's Business Settings.

Note: Privy will not approve purchased lists or mailing lists that contain non-permission-based contacts. If an import is rejected, you will receive an email from the Compliance Team, and the import will have a Rejected status in the Import section of your account's Business Settings.

Import via linked account

Use the Contacts dashboard

Some integrations, such as Shopify, Constant Contact, Smile, and Mailchimp, allow you to import contacts directly into Privy from the Contacts dashboard. To check if one of your linked accounts supports this functionality: 

  • In your Privy account, select Contacts from the main navigation. 
  • On the Contacts dashboard, select the Add Contacts dropdown menu. 
  • Select the Linked Accounts option from the dropdown menu. If one of your linked accounts supports this functionality, it will be available in the prompt's dropdown menu. 
  • Select a supported linked account and the list of contacts that you'd like to import. 
  • Click the Import Contacts button.

Use the checkout process

The Shopify, Shopify Plus, and Weebly integrations automatically create or update contacts in Privy when a customer's email address is collected during your store's checkout process. The email address used during checkout is captured in Privy as an 'order' and is used to generate or update a contact's profile. An address is captured when the customer has either:

  • Completed a purchase.
  • Reached the payment step of the checkout process. 

The information in any subsequent profile is a combination of what was collected during checkout and any previous interactions the customer had with your communications. With this in mind, please review the following:

  • Deduplication: If a contact profile already exists for the provided email address, any new orders will be added to the existing profile.
  • Reachability: If a contact checks the subscribe box as part of the order process, they will be marked as mailable unless they previously became ineligible due to hard bounces or by marking your emails as spam. If a contact does not check the box, their eligibility within Privy will remain unchanged. If the provided address is associated with a previously deleted profile, a new profile will be created using the contact's last known eligibility state.

Create contacts manually

To create contacts directly within Privy:

  • In your Privy account, select Contacts from the main navigation. 
  • On the Contacts dashboard, select the Add Contacts option. 
  • Select the Add Contact option from the dropdown menu.
  • You will be prompted for the contact's email address, first name, and last name. Only the email address is required. After providing the desired information, click Save

The contact's profile is created immediately and should be available after a page refresh. Select the profile to input additional information or unsubscribe the contact from future communications. 

Note: A previously unsubscribed contact cannot be resubscribed via these steps. While mailable is the default state of new contacts, an error message will appear when attempting to apply the subscribed status to an unsubscribed contact. Instead, the contact will remain unsubscribed until they opt back in via your checkout process or an onsite display with the same email address.

0 out of 0 found this helpful

scroll to top icon