Overview
This node integrates with the FullFunnel (GoHighLevel) platform to manage sales opportunities. It allows users to perform various operations on opportunities such as creating new ones, retrieving details of a specific opportunity, updating existing opportunities, changing their status, deleting them, and searching or listing multiple opportunities with filters.
Common scenarios where this node is beneficial include:
- Automating the creation of sales opportunities when new leads are captured.
- Fetching detailed information about a particular opportunity for reporting or follow-up.
- Updating opportunity details based on changes in the sales process.
- Changing the status of an opportunity as it progresses through different stages.
- Deleting obsolete or incorrect opportunities.
- Searching or listing opportunities based on criteria like pipeline, status, assigned user, or date ranges.
Practical example: A sales automation workflow could use this node to create an opportunity when a contact fills out a form, then update its status to "Won" once the deal closes, and finally retrieve all won opportunities for monthly sales reports.
Properties
| Name | Meaning |
|---|---|
| Opportunity ID | The unique identifier of the opportunity to get, update, delete, or change status for. |
Output
The node outputs JSON data representing the opportunity or opportunities involved in the operation:
- For Get operation: Outputs a single opportunity object with its full details.
- For Get All or Search operations: Outputs an array of opportunity objects matching the criteria.
- For Create, Update, and Update Status operations: Outputs the updated or created opportunity object.
- For Delete operation: Outputs a success confirmation with the deleted opportunity ID.
The output field json contains the opportunity data as returned by the FullFunnel API, including fields like pipeline IDs, contact IDs, monetary values, status, assigned user, tags, custom fields, and notes.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for FullFunnel (GoHighLevel) API authentication.
- The node uses the FullFunnel REST API endpoint at
https://rest.gohighlevel.com/v2. - Proper configuration of the API credentials in n8n is necessary for successful requests.
Troubleshooting
- Invalid JSON in custom fields: When providing custom fields as JSON, ensure the JSON syntax is correct. Malformed JSON will cause an error.
- API Authentication Errors: If the API key or credentials are invalid or missing, requests will fail. Verify that the FullFunnel API credentials are correctly set up in n8n.
- Opportunity Not Found: When using the Get, Update, Delete, or Update Status operations, if the provided Opportunity ID does not exist, the API may return an error. Confirm the ID is correct.
- Rate Limits or Pagination: For Get All or Search operations, the node fetches up to 100 results per request and can paginate up to 500 results. Requests exceeding these limits may require additional handling.
- Network Issues: Connectivity problems to the FullFunnel API endpoint will cause failures. Check network access and proxy settings if applicable.