Actions26
Overview
This node integrates with the GoHighLevel V2 API to manage "Opportunity" resources, specifically allowing users to create new opportunities within their sales pipelines. It is useful in scenarios where automation workflows need to programmatically add sales opportunities based on triggers or data from other systems, such as CRM updates, lead generation forms, or marketing campaigns.
For example, when a new lead is qualified in another system, this node can automatically create an opportunity in GoHighLevel, assigning it to a specific pipeline and stage, optionally linking it to a contact, and setting custom fields or monetary values.
Properties
| Name | Meaning |
|---|---|
| Name | The name/title of the opportunity to be created. |
| Pipeline ID | The identifier of the sales pipeline to which this opportunity belongs. |
| Pipeline Stage ID | The identifier of the specific stage within the pipeline where the opportunity currently resides. |
| Status | The current status of the opportunity; options are: Open, Won, Lost. |
| Contact ID | (Optional) The identifier of the contact associated with this opportunity. |
| Additional Fields | A collection of optional extra fields to set on the opportunity, including: |
| - Contact ID (alternative way to specify associated contact) | |
| - Custom Fields: Multiple user-defined fields with name/ID and value pairs | |
| - Monetary Value: Numeric value representing the opportunity's worth | |
| - Name: Opportunity name (can override main Name property) | |
| - Pipeline ID: Pipeline identifier (can override main Pipeline ID) | |
| - Pipeline Stage ID: Pipeline stage identifier (can override main Pipeline Stage ID) |
Output
The node outputs JSON objects representing the created opportunity records as returned by the GoHighLevel API. Each output item contains the full details of the newly created opportunity, including its assigned IDs, status, pipeline information, and any custom fields set.
If multiple items are processed, the output is an array of such JSON objects.
No binary data output is produced by this node.
Dependencies
- Requires an active connection to the GoHighLevel API via OAuth2 authentication.
- The node depends on the GoHighLevel V2 API version "2021-07-28".
- Proper credentials must be configured in n8n for API access.
- The node uses internal helper methods to fetch available custom fields dynamically for opportunities.
Troubleshooting
Common Issues:
- Missing required fields such as "Name" or "Pipeline Stage ID" will cause errors.
- Invalid or expired API credentials will result in authentication failures.
- Providing incorrect pipeline or stage IDs that do not exist in the GoHighLevel account may cause API errors.
- Custom field IDs must be valid and correspond to existing custom fields in GoHighLevel.
Error Messages:
"The resource "opportunity" is not known!"— This indicates an invalid resource parameter; ensure "Opportunity" is selected.- API errors related to permissions or invalid data will be passed through; check the error message for specifics.
Resolution Tips:
- Verify all required parameters are provided and correctly formatted.
- Confirm API credentials are valid and have sufficient permissions.
- Use the node’s load options to select valid custom fields and pipeline stages.
- Enable "Continue On Fail" if you want the workflow to proceed despite individual item errors.