Import contacts: Difference between revisions

From Activepedia
Jump to navigation Jump to search
(SEO-optimized content from ActiveCampaign documentation)
(SEO-optimized content from ActiveCampaign documentation)
Line 1: Line 1:
```mediawiki
```
'''Navigation:''' [[Main_Page]] > [[Contacts]] > [[Importing]] > Import contacts
'''Navigation:''' [[Main_Page]] > [[Contacts]] > [[Import]] > Import contacts


== How do I import contacts using the copy and paste option? ==
== How to Import Contacts into ActiveCampaign from a CSV File ==


The '''copy and paste import option''' allows you to quickly import contacts into ActiveCampaign. This method is particularly useful for shorter lists or when you have a limited number of custom fields. Understanding how to efficiently import your contacts can greatly enhance your marketing efforts and keep your contact lists organized.
With ActiveCampaign, you can easily import contacts into your account from a CSV file using the built-in import tool. This feature is crucial for users transitioning from another email marketing or marketing automation provider, allowing you to retain your valuable lists, contacts, custom fields, and other necessary data seamlessly. This article will walk you through the steps to import contacts efficiently, ensuring that you can get your email campaigns up and running without losing any critical information.


=== How to Access this Feature ===
=== Introduction ===
To access the copy and paste import feature:
The import tool provided by ActiveCampaign enables you to map columns from your CSV file to fields within your account. This capability allows for considerable flexibility, including the option to create new custom contact fields, apply unique tags, and choose whether to import contacts as Active or Excluded. This importing feature is essential for maintaining and building your marketing automation strategies.
1. Navigate to the '''Contacts Overview''' page within your ActiveCampaign dashboard.
2. Click on the '''Import''' button located on the page.


=== Step-by-Step Instructions ===
In this article, you'll learn:
Follow these steps to import contacts using the copy and paste option:
* How to access the import feature.
* Step-by-step instructions for importing contacts from a CSV file.
* Configuration options and settings that can be customized during the import process.
* Best practices to ensure successful imports.
* Common troubleshooting tips to resolve potential issues.
* Frequently asked questions about the import feature.


1. **Initiate Import**: From the '''Contacts Overview''' page, click on the '''Import''' button.
=== How to Access This Feature ===
To access the import contacts feature, follow these simple steps:
1. Log into your ActiveCampaign account.
2. Locate and click on '''Contacts''' in the left menu.
3. Click on the '''Import''' button, which will take you to the import options.


2. **Select Copy & Paste Option**: Click the '''Copy & paste your contacts''' link.
=== Step-by-Step Instructions ===
 
To import contacts from your CSV file, follow these steps:
3. **Input Contacts**: A copy and paste import modal will appear. Here’s how to format your list for import:
  - If you are importing only email addresses, list each one on a separate line, like this:
    ```
    sarah@test.com
    ellen@test.com
    ```
  - If entering names, email addresses, and custom fields, format like this, with items separated by commas and no spaces:
    ```
    Sarah,Connor,sarah@test.com,October Import
    Ellen,Ripley,ellen@test.com,October Import
    ```
  - When pasting from a spreadsheet, there's no need to use commas.
 
4. **Proceed with the Import**: Once you have entered your contacts, click the '''Next''' button.
 
5. **Map Your Fields**: Your file will process, and you will be taken to the import screen. Here, you can '''map the columns''' in your file to fields in your account by using the dropdown for each field.
  - If there’s a column with information you do not wish to import, select '''Do Not Import this Field'''.
  - To create a new field from this import, click on '''[Add New Field]''' and follow the prompts.
  - Check the '''Field Values''' column to confirm your mapping; it will show the first row of data from your CSV.
 
6. **Select Lists (Optional)**: Click each list where you want to add contacts. You can add contacts to multiple lists.
 
7. **Add Tags (Optional)**: In this step, type any tags you wish to apply to all contacts being imported. It is a best practice to apply a tag indicating the source of these contacts for future reference.
 
8. **Configure Import Options**: Click the '''Import Options''' dropdown and choose one:
  - '''Import as Contact''': Adds the contact to your ActiveCampaign account.
  - '''Import as Excluded''': Adds the contact to your '''Exclusion List''' upon import.
  - If you have chosen any list in the '''Select Lists''' section, additional options will appear for specific import statuses:
    - '''Import as Active Contact''': Subscribes the contact to the chosen list.
    - '''Import as Unsubscribed Contact''': Adds the contact as unsubscribed to the chosen list.
    - '''Import as Excluded Email Address''': Adds the contact to your '''Exclusion List'''.
 
9. **Update Existing Contacts (Optional)**: Check the '''Update Existing Contacts''' box if you want the system to look for existing matching email addresses and update contact details from your file.


10. **Access Advanced Options (Optional)**: Click the arrow next to '''Advanced Options''' to view additional settings:
# Click the '''Import from File''' button.
    - '''Trigger Webhooks''': Choose to turn off completely or trigger selected webhooks upon import.
# A file browser will appear. Navigate to your CSV file, select it, and click open.
    - '''Trigger Automations''': Decide if imported contacts enter relevant automations.
# Once the file processes, you will be redirected to the import screen where you can begin mapping fields.
    - '''Create field options when importing new custom field values''': Opt to create new options for dropdowns and other fields that do not match existing entries.
# For each field, you need to map the columns in your file to the fields in your account. Click the dropdown for each field to make selections.
  * If you wish not to import data from a specific column, select '''Do Not Import this Field'''.
  * To create a new field directly from the import page, click '''[Add New Field]''' and follow the prompts.
  * The '''Field Values''' column will show the first row of data from your CSV, allowing you to confirm your mappings.
  * If duplicate fields are detected, an error will be indicated. Choose different destinations for each mapped field to fix this.


11. **Final Import**: Once everything is configured, click the '''Import Now''' button to start the import process.
# Select the lists to which you want to add the contacts by checking the appropriate options. You can add contacts to multiple lists as needed.
# Optionally, type any tags you wish to apply to the imported contacts in the '''Add Tags''' section. For better organization, consider applying a tag indicating the source of the contacts.
# Under '''Import Options''', select one of the following based on whether or not you selected a list:
  * '''Import as Contact''' – Adds contacts to your account (only if no list is selected).
  * '''Import as Excluded''' – Adds contacts to your Exclusion List (only if no list is selected).
  * '''Import as Active Contact''' – Adds contacts to the selected list(s).
  * '''Import as Unsubscribed Contact''' – Adds contacts but with an "Unsubscribed" status for the selected list(s).
  * '''Import as Excluded Email Address''' – Adds contacts to the Exclusion List (if lists are selected).
# Optionally, check the '''Update Existing Contacts''' box to merge any matching email addresses or exact phone numbers with existing contacts in your account. Note: Phone-only contacts must be enabled to use phone numbers as unique identifiers.
# The '''Advanced Options''' feature allows you to adjust additional settings:
  * To manage webhook triggers, choose between turning them off or triggering specific actions upon contact import.
  * To control automation triggers, you may decide to allow or disallow contacts from entering automations they could trigger during the import.
  * Field options for new custom fields can also be created during import, depending on whether or not the values in your CSV match existing options.
# Finally, when you have configured all necessary settings, click the '''Import Now''' button.


The duration of the import process will depend on how many contacts you are pasting into the system.
The time taken to complete the contact import process will depend on the size of the CSV file you are importing.


=== Configuration Options and Settings ===
=== Configuration Options and Settings ===
During the import process, you will encounter multiple options which allow you to customize how your contacts are handled:
When importing contacts into ActiveCampaign, several configuration options allow you to customize the process:


- **Import as Contact**: This option ensures that imported emails become active contacts in your account.
* '''Import as Contact''' - This option adds the newly imported contacts to your main contact list.
- **Import as Excluded**: This option is useful if you want to keep certain email addresses from being active contacts.
* '''Import as Excluded''' - This allows you to automatically exclude certain contacts from your marketing efforts.
- **Update Existing Contacts**: This check will allow the system to modify any existing contacts using details found in your import.
* '''Import as Active Contact''' & '''Import as Unsubscribed Contact''' - These options dictate the status of contacts with respect to the list they’re being added to.
- **Trigger Webhooks**: Managing webhook triggers allows you to sync various actions with other systems you may be using.
* '''Update Existing Contacts''' - Enabling this allows any new data from the import to overwrite existing contact data.
- **Trigger Automations**: Automations can include actions like tagging contacts upon import.
* '''Trigger Webhooks''' - Control whether webhooks are activated during the import process.
- **Create Field Options**: For new custom field values, allowing their creation can help accommodate variations in data entry.
* '''Trigger Automations''' - Allows you to define if imported contacts will enter any active automations that they are eligible for.
* '''Create Field Options''' - This toggle allows for the creation of new options in custom fields during the import process.


=== Best Practices and Tips ===
=== Best Practices and Tips ===
- Always use clear formatting when copying and pasting information to prevent errors.
- Before importing, ensure that your CSV file is correctly formatted and adheres to the necessary guidelines. For tips on preparing your CSV file, consult "How to prepare your CSV file for importing contacts."
- Utilize tagging to keep track of the source of imported contacts, aiding in organization and segmentation later.
- Each contact must have a unique email or phone number to avoid duplicates, as only the first instance will be imported.
- If possible, review existing contacts to avoid duplicates and ensure your list is as clean as possible prior to import.
- Apply tags for organization, enabling you to segment your contacts more effectively later on.
- Test your import with a small number of contacts to ensure everything is functioning as expected.
- Be clear on the implications of the '''Update Existing Contacts''' option, as it may change existing data if checked.


=== Common Use Cases ===
=== Troubleshooting Section ===
- Importing email subscribers from an offline event.
If you encounter issues during the importing process, consider the following troubleshooting tips:
- Merging lists from different sources into a single cohesive list.
- Ensure your CSV file is saved correctly as a CSV format and manually check for any formatting errors.
- Importing customers from a completed event or promotion, tagged accordingly for future marketing efforts.
- Verify that all contacts have unique email addresses or phone numbers; duplicates will be ignored beyond the first instance.
- If you encounter mapping errors, check for duplicate fields and confirm that each field is mapped correctly.
- For any technical issues that cannot be resolved, consult the ActiveCampaign support documentation or contact support for assistance.


=== Troubleshooting ===
=== Related Features ===
If you encounter issues during the import process:
For further information and extended functionalities related to contacts, you may refer to the following features:
- Ensure that your data is formatted correctly.
* [[Contacts]] - General management features for your contacts.
- Check for any error messages indicating field mapping issues or duplicates.
* [[Tags]] - Learn about tagging and segmenting your contacts.
- Review that your email addresses are valid and correctly formatted.
* [[Automation]] - Explore how to automate your marketing processes after importing contacts.
- Consult your accounts’ import logs to identify any specific problems related to the process.


=== FAQ ===
=== FAQ ===
'''Q1: What will happen if I try to import a duplicate email address?'''
'''Q1: Can I import contacts without an email address or phone number?'''
A1: The system will alert you with a message indicating that the email is a duplicate. You can choose to update the existing contact or skip the import for that address.
A1: No, each contact in your CSV must have either an email address or a phone number.


'''Q2: Can I import contacts without mapping fields?'''
'''Q2: What happens if multiple contacts share the same email address?'''
A2: No, you need to map at least some fields to ensure accurate data transfer into your ActiveCampaign account.
A2: Only the first instance of the contact will be imported; others will be skipped.


'''Q3: Is there a limit to the number of contacts I can import at once?'''
'''Q3: Can I create a new list during the import process?'''
A3: While there is no strict limit stated, it’s best to import in manageable batches for optimal processing.
A3: No, you must create a list beforehand if you want to assign contacts to it during the import.


'''Q4: Will imported contacts automatically be added to any automations?'''
'''Q4: How do I know if my contacts have been imported successfully?'''
A4: If you chose the option to trigger automations during the import process, yes, they will enter automations they can trigger.
A4: After completing the import process, you can view your import results to check for any errors or confirmations.


'''Q5: How can I check the results of my import?'''
'''Q5: Can I import tags during the contact import?'''
A5: After the import is complete, you can view the import results directly from the import summary screen or your account logs.
A5: Yes, you can apply tags to contacts during the import process.


'''Q6: What if I have custom fields that are not recognized during the import?'''
'''Q6: What file formats are supported for importing contacts?'''
A6: You can choose to create new fields during the import process for any custom values that don’t match existing options.
A6: The import tool only works with CSV file formats. Ensure your file is saved as a CSV before importing.


'''Q7: Can I cancel an import once I've started it?'''
'''Q7: Can I prevent imported contacts from triggering automations?'''
A7: Generally, it is advisable to not interrupt the import process; however, you can close your browser tab or window as a last resort.
A7: Yes, you can choose not to trigger automations during the import process in the Advanced Options section.


For further information on import options, consider checking additional resources in the guidance documentation of ActiveCampaign.
By following these guidelines and best practices, you can ensure a smooth and effective import of contacts into your ActiveCampaign account.
```
```

Revision as of 12:23, 3 November 2025

``` Navigation: Main_Page > Contacts > Import > Import contacts

How to Import Contacts into ActiveCampaign from a CSV File

With ActiveCampaign, you can easily import contacts into your account from a CSV file using the built-in import tool. This feature is crucial for users transitioning from another email marketing or marketing automation provider, allowing you to retain your valuable lists, contacts, custom fields, and other necessary data seamlessly. This article will walk you through the steps to import contacts efficiently, ensuring that you can get your email campaigns up and running without losing any critical information.

Introduction

The import tool provided by ActiveCampaign enables you to map columns from your CSV file to fields within your account. This capability allows for considerable flexibility, including the option to create new custom contact fields, apply unique tags, and choose whether to import contacts as Active or Excluded. This importing feature is essential for maintaining and building your marketing automation strategies.

In this article, you'll learn:

  • How to access the import feature.
  • Step-by-step instructions for importing contacts from a CSV file.
  • Configuration options and settings that can be customized during the import process.
  • Best practices to ensure successful imports.
  • Common troubleshooting tips to resolve potential issues.
  • Frequently asked questions about the import feature.

How to Access This Feature

To access the import contacts feature, follow these simple steps: 1. Log into your ActiveCampaign account. 2. Locate and click on Contacts in the left menu. 3. Click on the Import button, which will take you to the import options.

Step-by-Step Instructions

To import contacts from your CSV file, follow these steps:

  1. Click the Import from File button.
  2. A file browser will appear. Navigate to your CSV file, select it, and click open.
  3. Once the file processes, you will be redirected to the import screen where you can begin mapping fields.
  4. For each field, you need to map the columns in your file to the fields in your account. Click the dropdown for each field to make selections.
  * If you wish not to import data from a specific column, select Do Not Import this Field.
  * To create a new field directly from the import page, click [Add New Field] and follow the prompts.
  * The Field Values column will show the first row of data from your CSV, allowing you to confirm your mappings.
  * If duplicate fields are detected, an error will be indicated. Choose different destinations for each mapped field to fix this.
  1. Select the lists to which you want to add the contacts by checking the appropriate options. You can add contacts to multiple lists as needed.
  2. Optionally, type any tags you wish to apply to the imported contacts in the Add Tags section. For better organization, consider applying a tag indicating the source of the contacts.
  3. Under Import Options, select one of the following based on whether or not you selected a list:
  * Import as Contact – Adds contacts to your account (only if no list is selected).
  * Import as Excluded – Adds contacts to your Exclusion List (only if no list is selected).
  * Import as Active Contact – Adds contacts to the selected list(s).
  * Import as Unsubscribed Contact – Adds contacts but with an "Unsubscribed" status for the selected list(s).
  * Import as Excluded Email Address – Adds contacts to the Exclusion List (if lists are selected).
  1. Optionally, check the Update Existing Contacts box to merge any matching email addresses or exact phone numbers with existing contacts in your account. Note: Phone-only contacts must be enabled to use phone numbers as unique identifiers.
  2. The Advanced Options feature allows you to adjust additional settings:
  * To manage webhook triggers, choose between turning them off or triggering specific actions upon contact import.
  * To control automation triggers, you may decide to allow or disallow contacts from entering automations they could trigger during the import.
  * Field options for new custom fields can also be created during import, depending on whether or not the values in your CSV match existing options.
  1. Finally, when you have configured all necessary settings, click the Import Now button.

The time taken to complete the contact import process will depend on the size of the CSV file you are importing.

Configuration Options and Settings

When importing contacts into ActiveCampaign, several configuration options allow you to customize the process:

  • Import as Contact - This option adds the newly imported contacts to your main contact list.
  • Import as Excluded - This allows you to automatically exclude certain contacts from your marketing efforts.
  • Import as Active Contact & Import as Unsubscribed Contact - These options dictate the status of contacts with respect to the list they’re being added to.
  • Update Existing Contacts - Enabling this allows any new data from the import to overwrite existing contact data.
  • Trigger Webhooks - Control whether webhooks are activated during the import process.
  • Trigger Automations - Allows you to define if imported contacts will enter any active automations that they are eligible for.
  • Create Field Options - This toggle allows for the creation of new options in custom fields during the import process.

Best Practices and Tips

- Before importing, ensure that your CSV file is correctly formatted and adheres to the necessary guidelines. For tips on preparing your CSV file, consult "How to prepare your CSV file for importing contacts." - Each contact must have a unique email or phone number to avoid duplicates, as only the first instance will be imported. - Apply tags for organization, enabling you to segment your contacts more effectively later on. - Be clear on the implications of the Update Existing Contacts option, as it may change existing data if checked.

Troubleshooting Section

If you encounter issues during the importing process, consider the following troubleshooting tips: - Ensure your CSV file is saved correctly as a CSV format and manually check for any formatting errors. - Verify that all contacts have unique email addresses or phone numbers; duplicates will be ignored beyond the first instance. - If you encounter mapping errors, check for duplicate fields and confirm that each field is mapped correctly. - For any technical issues that cannot be resolved, consult the ActiveCampaign support documentation or contact support for assistance.

Related Features

For further information and extended functionalities related to contacts, you may refer to the following features:

  • Contacts - General management features for your contacts.
  • Tags - Learn about tagging and segmenting your contacts.
  • Automation - Explore how to automate your marketing processes after importing contacts.

FAQ

Q1: Can I import contacts without an email address or phone number? A1: No, each contact in your CSV must have either an email address or a phone number.

Q2: What happens if multiple contacts share the same email address? A2: Only the first instance of the contact will be imported; others will be skipped.

Q3: Can I create a new list during the import process? A3: No, you must create a list beforehand if you want to assign contacts to it during the import.

Q4: How do I know if my contacts have been imported successfully? A4: After completing the import process, you can view your import results to check for any errors or confirmations.

Q5: Can I import tags during the contact import? A5: Yes, you can apply tags to contacts during the import process.

Q6: What file formats are supported for importing contacts? A6: The import tool only works with CSV file formats. Ensure your file is saved as a CSV before importing.

Q7: Can I prevent imported contacts from triggering automations? A7: Yes, you can choose not to trigger automations during the import process in the Advanced Options section.

By following these guidelines and best practices, you can ensure a smooth and effective import of contacts into your ActiveCampaign account. ```