OmniFlow icon

OmniFlow

Consume OmniFlow API

Actions20

Overview

This node integrates with the OmniFlow API to manage company data within workflows. Specifically, the "Company" resource with the "Get Many" operation allows users to retrieve multiple company records from OmniFlow. It supports fetching all companies or a limited subset, with options to filter, sort, and simplify the returned data.

Common scenarios where this node is beneficial include:

  • Synchronizing company data from OmniFlow into other systems.
  • Generating reports or dashboards based on company information.
  • Automating marketing or sales workflows that require bulk access to company details.

For example, a user might configure this node to fetch all companies sorted by name in ascending order, then pass the simplified list of company names and IDs to another node for further processing.

Properties

Name Meaning
Authentication Method to authenticate with OmniFlow API: either using standard credentials or OAuth2.
Return All Whether to return all matching company records (true) or limit the number of results (false).
Limit Maximum number of company records to return when Return All is set to false. Must be at least 1.
Simplify Whether to return a simplified version of each company record (only core fields) instead of the full raw response data.
Additional Fields Optional parameters to refine the query:
- Order Direction Sort direction for the results: ascending (asc) or descending (desc).
- Order By Field to sort the results by. Can be any column available in the company data, selectable from a dynamic list or specified via expression.
- Search A string or search command to filter companies by specific criteria.

Output

The output is a JSON array containing company objects retrieved from OmniFlow:

  • When Simplify is enabled, each item contains only the core company fields under fields.all.
  • When Simplify is disabled, the full raw company data as returned by the API is included.
  • If Return All is true, all matching companies are returned; otherwise, up to the specified Limit.

No binary data is output by this node.

Example simplified output item structure (conceptual):

{
  "companyname": "Example Corp",
  "companyemail": "[email protected]",
  "companyphone": "+1234567890",
  "companyindustry": "Technology",
  ...
}

Dependencies

  • Requires an active OmniFlow API connection configured in n8n, authenticated either via credentials or OAuth2.
  • The node uses internal helper functions to make HTTP requests to OmniFlow endpoints.
  • No additional external dependencies beyond the OmniFlow API and proper authentication.

Troubleshooting

  • Error: Invalid API response or errors field present
    This can occur if the API request parameters are incorrect or the API returns an error. Verify the Additional Fields parameters such as orderBy and search are valid and correctly formatted.

  • Empty result set
    If no companies are returned, check the Search parameter for overly restrictive filters or confirm that companies exist in the OmniFlow account.

  • Authentication failures
    Ensure the selected authentication method is properly configured with valid credentials or OAuth2 tokens.

  • Limit ignored when Return All is true
    This is expected behavior; setting Return All to true overrides the limit and fetches all records.

Links and References

Discussion