Workflow Action – Merge Contact

Modified on: Thu, 12 Mar, 2026 at 9:59 AM


Workflow Action – Merge Contact gives you an automated way to deduplicate contacts directly inside HighLevel workflows. It helps reduce CRM clutter, protect contact history, and keep follow-up actions running on the correct surviving record. This article explains what the feature does, when to use it, how to configure it, and how to verify merge activity in Execution Logs.


TABLE OF CONTENTS


What is Merge Contact Workflow Action?


Workflow Action – Merge Contact helps you automatically merge duplicate contacts while a workflow is running in HighLevel. Instead of manually cleaning up duplicate records from the Contacts area, this action checks the enrolled contact against existing records using your selected match criteria and merges the newer record into the older one when a duplicate is found. This keeps your CRM cleaner, reduces duplicate communication, and supports more accurate automation and reporting.


Key Benefits of Merge Contact Workflow Action


  • Automated deduplication: Detects and merges duplicate contacts as they move through a workflow, reducing manual cleanup from the Contacts page.

  • Flexible matching options: Lets you identify duplicates by Email, Phone Number, or Email and Phone Number, depending on how strict you want the match to be.

  • Cleaner CRM data: Helps reduce duplicate records that can affect reporting, communication history, and workflow accuracy.

  • Protected workflow continuity: Allows the workflow to continue on the surviving contact record after a merge.

  • Better operational visibility: Makes it easier to review merge behavior using Workflow Execution Logs.


Action Details


Field
Description
Action Name
A custom name for the action. Defaults to “Merge Contact.”
Match By *
Select how duplicate contacts should be identified. Options:
  • Email – Matches contacts that share the same email address.
  • Phone Number – Matches contacts that share the same phone number.
  • Email and Phone Number – Matches only if both email and phone number are identical.

How to Use Merge Contact Workflow Action


Follow these steps to add the action to a workflow and configure it for consistent, predictable outcomes.


  1. Log in to your sub-account.

  2. Go to Automations > Workflows.


     

  3. Create a new workflow or open an existing one.



  4. Click on the + Add New Trigger button to add a trigger that correlates to the Merge Contact Action (e.g., Contact Created, Form Submitted, Contact Changed.)



  5. Add the Contact Merged Action.

  6. In Match Criteria, choose one of the available options:

    • Email

    • Phone Number

    • Email and Phone Number

  7. Save the action.



  8. Publish and Save the workflow.


Merge Behavior


When the action executes, it follows this logic:


  1. The system searches for an existing contact that matches the enrolled contact based on the selected Match By criteria.

  2. If a duplicate is found, the newer contact is always merged into the older contact. The older record is preserved as the primary, ensuring no historical data is lost.

  3. If the enrolled contact is the older record, the duplicate is merged into it. If the enrolled contact is the newer record, it is merged into the older duplicate.

  4. If no duplicate is found, the action completes with no changes – the contact moves to the next step in the workflow as-is.

Frequently Asked Questions


Q: Does Workflow Action – Merge Contact replace Contact Deduplication Preferences?
No. Deduplication preferences help reduce duplicate creation at the source, while Merge Contact handles duplicates automatically during workflow execution.

Q: When should I use this action instead of the Duplicate Management & Merge Tool?
Use Merge Contact when you want automation to handle duplicates during a workflow. Use the Duplicate Management & Merge Tool when you want to manually review and merge records from the Contacts area.


Q: What happens if no duplicate is found?
The action is skipped and the workflow continues normally.


Q: Which contact record is kept after a merge?
The older contact record is preserved as the surviving record.


Q: Can the workflow continue after a contact is merged?

Yes. The workflow continues on the surviving contact record after the merge is completed.


Q: What is the safest match option to use?
Email and Phone Number is typically the strictest option and may be safer when you want to reduce unintended merges, but the best option depends on the quality and consistency of your contact data.


Q: Should I test this before using it in a live workflow?
Yes. Testing with sample contacts helps confirm your selected match criteria behave as expected before you apply the action to larger workflows.


Q: Can I still use the Contacts duplicate-management tools after enabling this action?
Yes. Workflow-based merging and manual duplicate management can be used together as part of a broader contact-cleanup strategy.



Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article