Overview
This node integrates with the FullFunnel (GoHighLevel) platform to manage sales opportunities. Specifically, the Search operation under the Opportunity resource allows users to search for opportunities based on various criteria such as pipeline, stage, status, assigned user, contact, date range, and a free-text query.
Typical use cases include:
- Retrieving filtered lists of sales opportunities to analyze pipeline health.
- Searching for specific opportunities matching keywords or assigned users.
- Automating reporting workflows by fetching opportunities created or updated within certain time frames.
- Integrating opportunity data into other systems or dashboards.
For example, you could use this node to find all "Open" opportunities assigned to a particular salesperson in the last 7 days or search for opportunities containing a specific keyword in their details.
Properties
| Name | Meaning |
|---|---|
| Return All | Whether to return all matching results or limit the number of returned items. If true, the node fetches up to 500 results in batches of 100. |
| Limit | Maximum number of results to return when "Return All" is false. Accepts values from 1 to 100. |
| Filters | Collection of filters to narrow down the search: |
| Pipeline ID | Filter opportunities by a specific pipeline ID. |
| Pipeline Stage ID | Filter opportunities by a specific pipeline stage ID. |
| Status | Filter by opportunity status. Options: All, Open, Won, Lost, Abandoned. Default is All. |
| Assigned To | Filter by assigned user ID. |
| Contact ID | Filter by contact ID associated with the opportunity. |
| Date Range | Filter by creation or update date range. Options: All Time, Today, Yesterday, Last 7 Days, Last 30 Days, This Month, Last Month. Default is All Time. |
| Query | Free-text search query to match against opportunity data. Only shown for the Search operation. |
Output
The node outputs an array of JSON objects representing opportunities matching the search criteria. Each item corresponds to one opportunity and contains fields as returned by the FullFunnel API, typically including:
- Opportunity identifiers (ID)
- Pipeline and stage information
- Status (open, won, lost, abandoned)
- Assigned user
- Contact association
- Monetary value
- Tags and custom fields
- Creation and update timestamps
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for FullFunnel (GoHighLevel) to authenticate requests.
- The node uses the FullFunnel REST API v2 endpoint
https://rest.gohighlevel.com/v2. - Proper configuration of the API credential in n8n is necessary.
- The node internally handles pagination when "Return All" is enabled, fetching up to 500 records in batches of 100.
Troubleshooting
- Invalid JSON in Custom Fields: When providing custom fields as JSON, ensure the JSON syntax is correct. Malformed JSON will cause errors.
- API Authentication Errors: Verify that the API key credential is valid and has sufficient permissions.
- Rate Limits or Pagination Issues: The node fetches up to 500 results when returning all. Requests beyond this limit are not supported and may require additional handling.
- Filter Misconfiguration: Using invalid IDs or unsupported filter values may result in empty responses or errors.
- Error Messages: The node surfaces error messages from the API. Common errors include invalid parameters or unauthorized access. Review the error message details for guidance.
If the node is set to continue on failure, it will output error details per item instead of stopping execution.