FullFunnel Opportunities

Gerenciar oportunidades/negócios na FullFunnel (GoHighLevel)
Join our community

Actions7

Overview

This node manages sales opportunities within the FullFunnel (GoHighLevel) platform. It allows users to create, retrieve, update, delete, search, and manipulate the status of opportunities in a sales pipeline.

The Create Opportunity operation specifically enables users to add new sales opportunities by specifying details such as the pipeline, stage, associated contact, monetary value, and other optional metadata. This is useful for automating lead management workflows, integrating CRM data, or syncing sales pipelines from other systems.

Practical examples:

  • Automatically creating an opportunity when a new lead is captured via a web form.
  • Adding opportunities based on marketing campaign responses with relevant tags and source information.
  • Assigning newly created opportunities to specific sales reps programmatically.

Properties

Name Meaning
Pipeline ID The identifier of the sales pipeline where the opportunity belongs.
Pipeline Stage ID The identifier of the specific stage within the pipeline for this opportunity.
Contact ID The identifier of the contact associated with this opportunity.
Opportunity Name The name/title of the opportunity. If not provided, defaults to "Opportunity - [timestamp]".
Monetary Value The estimated monetary value of the opportunity, with two decimal precision.
Additional Fields A collection of optional fields to further describe the opportunity:
- Status Current status of the opportunity. Options: Open, Won, Lost, Abandoned.
- Assigned To User ID to whom the opportunity is assigned.
- Source Origin/source of the opportunity (e.g., Website, Facebook, Google Ads).
- Tags Comma-separated list of tags for categorization.
- Custom Fields JSON object containing custom-defined fields for extended data.
- Notes Additional textual notes about the opportunity.

Output

The node outputs JSON objects representing the created opportunity. The structure typically includes all properties of the opportunity as returned by the FullFunnel API, including IDs, names, statuses, monetary values, and any additional fields set during creation.

If the API response contains an opportunity object, it is output directly; otherwise, the full response is output.

No binary data is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the FullFunnel (GoHighLevel) REST API.
  • The node uses the base URL https://rest.gohighlevel.com/v2 for API requests.
  • The location ID is retrieved from the credentials and included in the request body for scoping.

Troubleshooting

  • Invalid JSON in custom fields: If the customFields property contains malformed JSON, the node will throw an error. Ensure that the JSON string is valid before inputting.
  • Missing required fields: The operation requires pipelineId, pipelineStageId, and contactId. Omitting these will cause errors.
  • API authentication errors: Make sure the API key credential is correctly configured and has permissions to manage opportunities.
  • Network or API errors: The node surfaces errors from the FullFunnel API. Check network connectivity and API status if requests fail.
  • Tags formatting: Tags should be comma-separated strings; improper formatting may lead to unexpected results.

Links and References

Discussion