FullFunnel Opportunities

Gerenciar oportunidades/negócios na FullFunnel (GoHighLevel)

Overview

This node integrates with the FullFunnel (GoHighLevel) platform to manage sales opportunities. Specifically, the Get All operation for the Opportunity resource retrieves multiple opportunity records based on various filters and pagination options.

Typical use cases include:

  • Fetching all or a subset of sales opportunities for reporting or dashboard purposes.
  • Filtering opportunities by pipeline, stage, status, assigned user, contact, or date range.
  • Searching opportunities using a text query.
  • Automating workflows that require bulk access to opportunity data from FullFunnel.

For example, a sales manager could use this node to pull all "Open" opportunities assigned to a specific user within the last 30 days to analyze pipeline health.


Properties

Name Meaning
Return All Whether to return all matching results or limit the number of returned opportunities.
Limit Maximum number of opportunities to return if not returning all (minimum 1, maximum 100).
Filters Collection of filters to narrow down the opportunities:
- Pipeline ID Filter opportunities by a specific pipeline identifier.
- Pipeline Stage ID Filter opportunities by a specific pipeline stage identifier.
- Status Filter by opportunity status. Options: All, Open, Won, Lost, Abandoned.
- Assigned To Filter by the user ID to whom the opportunity is assigned.
- Contact ID Filter by the contact ID associated with the opportunity.
- Date Range Filter opportunities by creation or update date. Options: All Time, Today, Yesterday, Last 7 Days, Last 30 Days, This Month, Last Month.
- Query (Only for Search operation) Text search query to find matching opportunities.

Output

The output is an array of JSON objects representing individual opportunities. Each object contains the opportunity's details as returned by the FullFunnel API, including fields such as pipeline ID, stage ID, status, assigned user, contact, monetary value, and custom fields.

If Return All is enabled and more than 100 results exist, the node automatically paginates through up to 500 results, aggregating them into the output.

No binary data is produced by this operation.


Dependencies

  • Requires an API key credential for FullFunnel (GoHighLevel) authentication.
  • The node uses the FullFunnel REST API v2 endpoint (https://rest.gohighlevel.com/v2).
  • Proper configuration of the API credential in n8n is necessary.
  • The node expects the credential to provide a locationId used in API requests.

Troubleshooting

  • Invalid JSON in custom fields: If custom fields are provided as JSON strings, ensure they are valid JSON. Malformed JSON will cause errors.
  • API Authentication Errors: Ensure the API key credential is correctly configured and has sufficient permissions.
  • Rate Limits / Pagination: When retrieving many records, the node fetches up to 500 items in batches of 100. Requests beyond this limit are not supported.
  • Filter Misconfiguration: Using invalid or empty filter values may result in no data returned or API errors.
  • Date Range Handling: The date range filter translates to ISO date strings; incorrect system time settings might affect filtering results.

Common error messages come directly from the FullFunnel API and are surfaced in the node output when Continue On Fail is enabled.


Links and References

Discussion