Actions26
Overview
The node integrates with the GoHighLevel V2 API to manage various CRM resources, including Opportunities. Specifically, the "Update Status" operation for the Opportunity resource allows users to change the status of an existing opportunity record within their GoHighLevel account.
This node is beneficial in scenarios where automated workflows need to update the sales pipeline status based on external triggers or internal logic. For example, when a deal is closed successfully, the workflow can automatically mark the opportunity as "Won," or if lost, mark it accordingly without manual intervention.
Practical examples:
- Automatically marking an opportunity as "Won" after receiving payment confirmation.
- Updating the status to "Lost" if a lead does not respond after multiple follow-ups.
- Resetting the status to "Open" when re-engaging a previously inactive opportunity.
Properties
| Name | Meaning |
|---|---|
| Opportunity ID | The unique identifier of the opportunity to update. This is required to specify which opportunity's status will be changed. |
| Status | The new status to assign to the opportunity. Options are: "Open", "Won", or "Lost". |
Output
The node outputs JSON data representing the updated opportunity object returned from the GoHighLevel API after the status update operation. This typically includes fields such as the opportunity ID, updated status, timestamps, and other related metadata.
If the node supports binary data output (not evident from the provided code), it would represent any associated files or attachments related to the opportunity, but this is not indicated here.
Dependencies
- Requires an active connection to the GoHighLevel V2 API.
- Needs an API authentication token configured via OAuth2 credentials within n8n.
- The node depends on internal utility modules and resource handlers bundled in the source (
./src/resourcesand./src/utils/gohighlevel).
Troubleshooting
Common issues:
- Invalid or missing Opportunity ID: Ensure the Opportunity ID provided exists and is correctly formatted.
- Authentication errors: Verify that the OAuth2 credentials are valid and have sufficient permissions.
- Network or API downtime: Check connectivity and GoHighLevel service status.
Error messages:
"The resource \"opportunity\" is not known!": This indicates an unsupported resource was selected; ensure "Opportunity" is chosen.- API error responses will be passed through; check the error message for details like invalid status values or permission issues.
To resolve errors, confirm input parameters, credential validity, and API availability.