Actions26
Overview
The node integrates with the GoHighLevel V2 API, enabling automation workflows to manage CRM data. Specifically, for the Opportunity resource and the Update Stage operation, it updates the pipeline stage of an existing opportunity in the GoHighLevel system.
This is useful in sales automation scenarios where you want to programmatically move opportunities through different stages of a sales pipeline based on triggers or other workflow logic. For example, when a deal progresses from "Negotiation" to "Contract Sent," this node can update the opportunity's stage accordingly without manual intervention.
Properties
| Name | Meaning |
|---|---|
| Opportunity ID | The unique identifier of the opportunity to update. This tells the node which record to modify. |
| Pipeline Stage ID | The identifier of the new pipeline stage to assign to the opportunity. |
Output
The node outputs JSON data representing the updated opportunity object as returned by the GoHighLevel API after changing its stage. This typically includes fields such as the opportunity's ID, name, current stage, and other metadata reflecting the updated state.
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to the GoHighLevel V2 API.
- Needs an API authentication token configured in n8n credentials (OAuth2 or similar).
- The node depends on internal helper functions (
handleOpportunityOperations) that handle the actual API calls for opportunity operations.
Troubleshooting
Common issues:
- Invalid or missing Opportunity ID or Pipeline Stage ID will cause the API call to fail.
- Authentication errors if the API credential is not set up correctly or has expired.
- Network connectivity problems preventing access to the GoHighLevel API.
Error messages:
"The resource "opportunity" is not known!"— indicates an unsupported resource was selected; ensure "Opportunity" is chosen.- API error responses related to invalid IDs or permissions will be surfaced as node execution errors.
Resolutions:
- Verify that the Opportunity ID and Pipeline Stage ID are correct and exist in your GoHighLevel account.
- Check and refresh API credentials in n8n.
- Ensure network access to the GoHighLevel API endpoint.
Links and References
- GoHighLevel API Documentation (for detailed API endpoints and data models)
- n8n documentation on creating custom nodes (for understanding node structure)