Overview
This node manages opportunities (also called deals) within the FullFunnel (GoHighLevel) platform. It allows users to create, retrieve, update, delete, search, and list sales opportunities in their FullFunnel account. This is useful for automating CRM workflows such as updating deal stages, assigning opportunities to team members, or syncing opportunity data with other systems.
Practical examples include:
- Automatically creating a new opportunity when a lead fills out a form.
- Updating an opportunity’s status or details based on external triggers.
- Retrieving all open opportunities for reporting or dashboard purposes.
- Searching opportunities by custom criteria like pipeline stage or assigned user.
Properties
| Name | Meaning |
|---|---|
| Opportunity ID | The unique identifier of the opportunity to get, update, delete, or change status. |
| Update Fields | Collection of fields to update on an existing opportunity: |
| - Name | New name/title of the opportunity. |
| - Monetary Value | Updated monetary value of the opportunity (number with 2 decimal precision). |
| - Pipeline ID | ID of the pipeline the opportunity belongs to. |
| - Pipeline Stage ID | ID of the pipeline stage the opportunity is currently in. |
| - Status | Current status of the opportunity. Options: Open, Won, Lost, Abandoned. |
| - Assigned To | User ID to whom the opportunity is assigned. |
| - Source | Source information for the opportunity (e.g., Website, Facebook). |
| - Tags | Comma-separated list of tags associated with the opportunity. |
| - Custom Fields | JSON object containing any custom fields for the opportunity. |
Output
The node outputs JSON objects representing the opportunity or operation result:
- For update operation, the output JSON contains the updated opportunity object returned from the API.
- The structure typically includes all standard opportunity fields such as id, name, monetaryValue, pipelineId, pipelineStageId, status, assignedTo, source, tags (as array), and customFields.
- In case of errors (if "Continue On Fail" is enabled), the output will contain an error message and additional details.
- No binary data output is produced by this node.
Example output JSON snippet for an updated opportunity:
{
"id": "12345",
"name": "Updated Opportunity Name",
"monetaryValue": 1500.00,
"pipelineId": "pipeline_1",
"pipelineStageId": "stage_3",
"status": "open",
"assignedTo": "user_789",
"source": "Website",
"tags": ["important", "Q2"],
"customFields": {
"customKey": "customValue"
}
}
Dependencies
- Requires an API key credential for FullFunnel (GoHighLevel) API authentication.
- The node uses the FullFunnel REST API v2 endpoint at
https://rest.gohighlevel.com/v2. - The user must configure the node with valid credentials that have access to the FullFunnel account.
- The node expects a location ID from the credentials to scope operations.
Troubleshooting
- Invalid JSON in custom fields: If the customFields input is not valid JSON, the node throws an error. Ensure the JSON syntax is correct.
- API authentication errors: If the API key or credentials are invalid or expired, requests will fail. Verify and update credentials.
- Opportunity ID required: For update operations, the opportunity ID must be provided; missing or incorrect IDs cause errors.
- Rate limits or network issues: API calls may fail due to rate limiting or connectivity problems. Retry or check network settings.
- Tags formatting: Tags should be comma-separated strings; improper formatting might cause unexpected behavior.
- Continue On Fail: Enabling this option allows the node to continue processing subsequent items even if one fails, returning error details in output.