Using the Find Opportunity Workflow Action

Overview

The Find Opportunity action is a powerful workflow step that searches your CRM for an existing opportunity associated with the contact currently in the workflow. You can define specific criteria to locate the most relevant opportunity record. Once found, this opportunity becomes the active record for any following opportunity-related actions in the workflow chain. If a matching opportunity cannot be found, the workflow will follow a separate path, allowing you to handle that situation appropriately.

How It Works

This action performs a search based on the filters you set. All filters are combined using an AND logic, meaning an opportunity must meet every single condition to be considered a match. If your search returns multiple opportunities, you can configure the action to select either the earliest (first created) or the latest (most recently created) one. The workflow then branches based on the result: one path for when an opportunity is found, and another for when it is not.

Important Consideration for Webhooks

If the workflow was triggered by an event that did not provide contact information, such as an inbound webhook, the action will not have a contact to search by. In these cases, you must configure the filters to use data from the webhook payload (like an email address or phone number) to locate the correct opportunity.

Configuring the Action

When you add the Find Opportunity action to your workflow, you will need to configure the following settings.

Action Name

Provide a descriptive name for this step. This is for your reference and helps you identify the action within the workflow builder.

Opportunity to be Found

Select whether you want to retrieve the Earliest or the Latest opportunity that matches your criteria.

Filters

This is where you define the search conditions. You can add multiple filters, and all conditions must be true for an opportunity to be selected.

• You can filter by any standard or custom field on the opportunity record, such as Opportunity Name, Status, or Followers.
• There is no limit to the number of filters you can apply.

Example Use Case

Imagine a scenario where a lead submits a contact form on your website. You want to check if an open opportunity already exists for them before taking action.

1. Trigger: A contact submits a form.
2. Action: Add a Find Opportunity step.
3. Configuration:
   • Action Name: "Check for Open Opportunity"
   • Opportunity to be Found: Latest
   • Filters:
     • Opportunity Name Contains the contact's email address.
     • Status Is "Open".
4. Branching:
   • If Opportunity Found: The workflow proceeds down this path. You could then use an Update Opportunity action to add notes or change the status.
   • If Opportunity Not Found: The workflow follows this path. You could then use a Create Opportunity action to start a new sales process for the lead.

This logic ensures you efficiently manage your pipeline by updating existing records where possible and only creating new ones when necessary.