# Workflow Action - Find Contact > Learn how to use GHL Customer Care’s Find Contact action to match by email, phone, or custom fields, handle found/not-found branches, and pair with Inbound Webhook. - Source: https://docs.ghlcustomercare.com/docs/workflows/contact-workflow-actions/workflow-action-find-contact - Section: Workflows / Contact Workflow Actions - Reading time: 6 min - Images: 7, each explained below --- The workflow action Find Contact allows you to pull a contact into a workflow based on search criteria like email. It also handles the case where no matching contact is found. --- **TABLE OF CONTENTS** - [What is Find Contact Workflow Action](#what-is-find-contact-workflow-action) - [Key Benefits of Find Contact Workflow Action](#key-benefits-of-find-contact-workflow-action) - [Supported Match Fields](#supported-match-fields) - [Matching Logic & Branching Behavior](#matching-logic-and-branching-behavior)  - [Configuring the "Find Contact" Workflow Action](#configuring-the-find-contact-workflow-action) - [Include additional emails or phone numbers (optional)](#include-additional-emails-or-phone-numbers-optional) - [Use Cases](#use-cases) - [Frequently Asked Questions](#frequently-asked-questions) - [Related Articles](#related-articles) --- # **What is Find Contact Workflow Action** The Find Contact workflow action enables you to **identify a contact** in your database using specified criteria, such as standard or custom fields. This action is perfect for workflows that are **triggered without a contact already specified**, but do have other **identifying information** such as an email. Normally, this action is used when the workflow is triggered by a trigger that does not already have a contact attached to it. For example, when the trigger is Inbound Webhook it will have a payload of one or more query parameters. If the queryParams do not include a user ID, but do include an email, or other identifying information, then the Find Contact action can be used to turn the email into a user ID so that actions can be run on that contact. --- ## **Key Benefits of Find Contact Workflow Action** - **Enhanced Workflow Efficiency:** Automates the contact search process, saving time and reducing manual errors. - **Flexible Search Capabilities:** Supports standard and custom fields, allowing precise and tailored contact searches. - **Contactless Integration:** Specifically designed for workflows triggered by a contactless triggers such as **Inbound Webhoo****k** - **Advanced Matching:** Includes external reference matching, enabling searches based on custom identifiers like “Stripe Customer ID.” - **Improved Customer Engagement:** Ensures accurate targeting for communications and follow-ups, enhancing customer interactions. - **Branching Support:** Automatically creates distinct paths in your workflow based on whether a contact is found or not, enabling tailored actions for each scenario. --- ## **Supported Match Fields** Choosing reliable fields improves match accuracy. Use unique identifiers when possible and ensure incoming data is formatted consistently before matching. - **Standard fields**: Email, Phone, First/Last Name, etc. (select from the picker). - **Custom fields**: Use your own fields (e.g., _Customer ID_, _Subscription Tier_). Ensure the custom field exists and is populated on the contact. - **External references**: Map webhook/app data like **Stripe Customer ID** to a custom field and match on it. --- ## **Matching Logic & Branching Behavior**  Predictable matching rules help you design safer automations and plan “Contact Found vs. Contact Not Found ” outcomes. - **AND logic across fields**: If you specify multiple fields, **all** must match to return a contact (e.g., _email AND phone AND custom field_). - **Branching**: The action exposes two paths - **Contact Found** and **Contact Not Found** \-so you can follow up accordingly (e.g., update fields vs. create contact). - **If multiple contacts could match**: Tighten criteria with more specific fields (e.g., add email or an external ID). Pair with **Contact Deduplication Preferences** and **Merge Duplicates** guidance when needed. --- ## **Configuring the "Find Contact" Workflow Action** Follow these steps to configure the "Find Contact" action in your workflow. ### **Access Workflow Settings** Navigate to the workflow builder inside **"Automation"** section in your CRM. Create a new workflow from scratch or select the existing workflow where you want to implement the **"Find Contact"** workflow action. ![Access Workflow Settings (image 1 of 7)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155054568172/original/frx13mRCX3L_q-7wBWOZyZLO6ig9t7zUgw.png) **Access Workflow Settings (image 1 of 7)** This screenshot appears in the "Access Workflow Settings" section of "Workflow Action - Find Contact". The text alongside this image reads: Navigate to the workflow builder inside "Automation" section in your CRM. Create a new workflow from scratch or select the existing workflow where you want to implement the "Find Contact" workflow action. Immediately after, the guide continues: Click “+” icon and select "Find Contact" action from the dropdown menu. - Where to go: Navigate to the workflow builder inside "Automation" section in your CRM. Create a new workflow from scratch or select the existing workflow where you want to implement the "Find Contact" workflow action. - Controls: "Automation", "Find Contact" - Next: Click “+” icon and select "Find Contact" action from the dropdown menu. ### ### **Add a New Action** Click **“+”** icon and select **"Find Contact"** action from the dropdown menu. ### ** ![Add a New Action (image 2 of 7)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155039249538/original/QeM8v2EHcsAv9Pjb6KYgMm5jB1HlsXax2Q.png) **Add a New Action (image 2 of 7)** This screenshot appears in the "Add a New Action" section of "Workflow Action - Find Contact". The text alongside this image reads: Click “+” icon and select "Find Contact" action from the dropdown menu. Immediately after, the guide continues: Provide a descriptive name, such as “Find Contact by Email.”. - What to choose: Click “+” icon and select "Find Contact" action from the dropdown menu. - Next: Provide a descriptive name, such as “Find Contact by Email.” ** ### **Name Your Action** Provide a descriptive name, such as **“Find Contact by Email.”** ![Name Your Action (image 3 of 7)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155039249578/original/F7sI1DcqMK1NL5qk-dvd3J0ozCIbDQBbvw.png) **Name Your Action (image 3 of 7)** This screenshot appears in the "Name Your Action" section of "Workflow Action - Find Contact". The text alongside this image reads: Provide a descriptive name, such as “Find Contact by Email.”. Immediately after, the guide continues: Options include First Name, Last Name, Email, Phone, and more. - What to fill in: Provide a descriptive name, such as “Find Contact by Email.” - Controls: “Find Contact by Email.” - Next: Options include First Name, Last Name, Email, Phone, and more. ### **Selecting Standard Fields** Options include First Name, Last Name, Email, Phone, and more. ![Selecting Standard Fields (image 4 of 7)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155039249673/original/gK9muzOm9tJ3EK88Yjkl3w_y2OPGHe9Qxg.png) **Selecting Standard Fields (image 4 of 7)** This screenshot appears in the "Selecting Standard Fields" section of "Workflow Action - Find Contact". The text alongside this image reads: Options include First Name, Last Name, Email, Phone, and more. Immediately after, the guide continues: If you haven't already created the custom field, Add unique fields such as “Customer ID” or “Subscription Tier.” If you have them already, Just scroll down to find the Custom Fields you have created within the system. - What this covers: Options include First Name, Last Name, Email, Phone, and more. - Next: If you haven't already created the custom field, Add unique fields such as “Customer ID” or “Subscription Tier.” If you have them already, Just scroll down to find the Custom Fields you have created within the system. ### **Selecting Custom Fields (optional)** If you haven't already created the custom field, Add unique fields such as “Customer ID” or “Subscription Tier.” If you have them already, Just scroll down to find the Custom Fields you have created within the system. ![Selecting Custom Fields (optional) (image 5 of 7)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155039249651/original/6ihylo4OdVHg-gBuJXxczL-wmQr2jSGGeg.png) **Selecting Custom Fields (optional) (image 5 of 7)** This screenshot appears in the "Selecting Custom Fields (optional)" section of "Workflow Action - Find Contact". The text alongside this image reads: If you haven't already created the custom field, Add unique fields such as “Customer ID” or “Subscription Tier.” If you have them already, Just scroll down to find the Custom Fields you have created within the system. Immediately after, the guide continues: Pair the action with triggers like "Inbound Webhook" to activate it dynamically. - What this covers: If you haven't already created the custom field, Add unique fields such as “Customer ID” or “Subscription Tier.” If you have them already, Just scroll down to find the Custom Fields you have created within the system. - Next: Pair the action with triggers like "Inbound Webhook" to activate it dynamically. ### **Configure Triggers** Pair the action with triggers like **"Inbound Webhook"** to activate it dynamically. ### **Plan branches** Build actions under Contact Found (e.g., Update Contact Field, Send Email) and under Contact Not Found (e.g., Create Contact). ### ![Plan branches (image 6 of 7)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155054565262/original/oxBKfAodT0DEOIu6uGMOBbElnooOdL7WEw.png) **Plan branches (image 6 of 7)** This screenshot appears in the "Plan branches" section of "Workflow Action - Find Contact". The text alongside this image reads: Build actions under Contact Found (e.g., Update Contact Field, Send Email) and under Contact Not Found (e.g., Create Contact). Immediately after, the guide continues: Validate the configuration using test data to ensure accuracy. Save the action once the setup is complete. - What this covers: Build actions under Contact Found (e.g., Update Contact Field, Send Email) and under Contact Not Found (e.g., Create Contact). - Next: Validate the configuration using test data to ensure accuracy. Save the action once the setup is complete. ### **Test and Save** Validate the configuration using test data to ensure accuracy. **Save** the action once the setup is complete. ### **Publish the Workflow** Enable the workflow to automate the contact search process effectively. --- ## **Include additional emails or phone numbers (optional)** By default, Find Contact matches only the contact’s primary **Email or Phone** field. If your contacts store Additional email addresses or phone numbers, you can include those values in the match: 1\. In Selecting Standard Fields, choose Email or Phone . 2\. Enable the checkbox under the selected field to **include additional emails/phone numbers** in the search. ![Include additional emails or phone numbers (optional) (image 7 of 7)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155064651745/original/Q5PCi-SWsi47qnF8AtWh-bKKLVUEKcuObA.png) **Include additional emails or phone numbers (optional) (image 7 of 7)** This screenshot appears in the "Include additional emails or phone numbers (optional)" section of "Workflow Action - Find Contact". The text alongside this image reads: 2. Enable the checkbox under the selected field to include additional emails/phone numbers in the search. Immediately after, the guide continues: These real-life examples show when to use Find Contact, which field to rely on first, and what to do if a match isn’t found. - What this covers: 2. Enable the checkbox under the selected field to include additional emails/phone numbers in the search. - Controls: Email or Phone, include additional emails/phone numbers - Next: These real-life examples show when to use Find Contact, which field to rely on first, and what to do if a match isn’t found --- ## **Use Cases** These real-life examples show when to use **Find Contact**, which field to rely on first, and what to do if a match isn’t found **1\. New lead coming from another tool (match by Email)** When a form, ad, or integration sends you someone’s email, use **Find Contact** with **Email**. **If Contact found:** continue your workflow—add a tag, update details, send a message. **If Contact not found:** create the contact, then keep going. **2\. Purchase or subscription update (match by a Customer ID)** Payment systems often send a stable customer number (like a _customer ID_). Store that in a custom field and find by that value. **If Contact found:** update plan, status, or lifetime value. **If Contact not found:** create the contact, save the customer ID, and proceed. **3\. Calendar booking (match by Email)** Scheduling apps usually require email. Use it to connect the booking to the right person. **If Contact found:** attach the appointment and send confirmations. **If Contact not found:** create the contact from the booking details and notify the team. **4\. Partner referral (match by Referral Code)** Partners pass a unique code so you can credit them. Save that code in a custom field and find by it. **If Contact found:** add/update the referral info and tag the contact. **If Contact not found:** create the contact with the referral code and start the right nurture. **5\. Online order without a customer ID (match by Email, optionally Last Name)** Stores sometimes send only email and name. Start with **Email**; add **Last Name** if many contacts share similar emails. **If Contact found:** update order history and totals. **If Contact not found:** create the contact and tag as “Customer.” --- ## **Frequently Asked Questions** **Q. What happens if the contact is not found?** Once the Find Contact action is configured it creates a branch, one for "contact found" and one for "contact not found". You can create whichever actions are appropriate on the "contact not found" branch. **Q. How does external reference matching work?** You can store external identifiers, such as a **“Stripe Customer ID,”** in a custom field. The Find Contact action uses this field to locate the corresponding contact in the CRM. **Q. Can I combine this action with other workflow actions?** Absolutely. The Find Contact action can be paired with other actions like **“Send Email”** or **“Update Contact”** to create complex workflows. **Q. Can I use multiple fields for the search?** Yes, you can configure multiple fields to refine the search criteria. All specified field values must match for the action to locate the contact (ex: this AND this AND this). **Q. Can I use other triggers?** In addition to the Inbound Webhook trigger you can pass the necessary merge fields in through a custom App Marketplace trigger (these are Premium triggers created by 3rd party developers to support their App Marketplace apps). --- ## **Related Articles**  - **[](https://docs.ghlcustomercare.com/docs/workflows/contact-workflow-actions/workflow-action-create-contact)**[](https://docs.ghlcustomercare.com/docs/workflows/contact-workflow-actions/workflow-action-create-contact)[Workflow Action — Create Contact](https://docs.ghlcustomercare.com/docs/workflows/contact-workflow-actions/workflow-action-create-contact) - [Workflow Action - Update Contact Field](https://docs.ghlcustomercare.com/docs/workflows/workflow-builder/workflow-action-update-contact-field) - [Workflow Trigger - Inbound Webhook](https://docs.ghlcustomercare.com/docs/workflows/developer-resources/workflow-trigger-inbound-webhook) - [Contact Deduplication Preferences (Allow Duplicate Contacts)](https://docs.ghlcustomercare.com/docs/settings/business-profile-settings/allow-duplicate-contacts-contact-deduplication-preferences) - [How to Merge Duplicate Contacts in GHL Customer Care](https://docs.ghlcustomercare.com/docs/contacts/smart-lists/how-to-manage-and-merge-duplicate-contacts)[](https://docs.ghlcustomercare.com/docs/contacts/smart-lists/how-to-manage-and-merge-duplicate-contacts)**[](https://docs.ghlcustomercare.com/docs/contacts/smart-lists/how-to-manage-and-merge-duplicate-contacts)** --- Documentation for GHL Customer Care. Support: support@ghlcustomercare.com