n8n-nodes-enerflo-v2

An n8n community node for the Enerflo GraphQL API v2. Exposes
every query and mutation in the schema, either through a searchable dropdown or
as free-form GraphQL.

Installation

Settings → Community Nodes → Install → n8n-nodes-enerflo-v2

Credentials

Field	Notes
GraphQL Endpoint	https://api.enerflo.io/graphql — shared across tenants
API Key	Sent as Authorization: Bearer …
Org Subdomain	Required. Sent as x-org; this is what routes to your tenant.

The endpoint is shared — your org is selected by the x-org header, not by the
hostname. Use the subdomain from your Enerflo URL: xyzsolarcompany from
https://xyzsolarcompany.enerflo.io.

Use Test in the credential modal to verify. It issues query { me { id } },
which exercises endpoint, token, and org routing in one call.

Usage

Query / Mutation mode

Pick an operation from the dropdown, supply its arguments in Variables (JSON)
keyed by the schema's argument names, and give the selection set in
Return Fields.

Return Fields holds only what goes inside the operation — the node builds the
wrapper, interpolates arguments, and declares variables from the schema.

Selecting fetchDeal with:

{ "id": "<deal-uuid>" }

finalizedProposal {
  selectedFinanceQuote {
    plugin
    activeFinanceApplication {
      externalFinanceApplicationId
    }
  }
}

sends:

query FetchDeal($id: String!) {
  fetchDeal(id: $id) {
    finalizedProposal {
      selectedFinanceQuote {
        plugin
        activeFinanceApplication {
          externalFinanceApplicationId
        }
      }
    }
  }
}

Outer braces on Return Fields are optional. Optional arguments you omit from
Variables are left off the query entirely. Missing required arguments fail the
node with a message naming them, rather than producing a malformed request.
Operations that return a scalar take no selection set — leave Return Fields
empty for those.

Custom GraphQL mode

Write the whole operation yourself, including variable declarations. Variables
(JSON) is passed through untouched. Use this for multi-root operations,
fragments, or aliases.

Options

Option	Effect
Return All	Pages through a *List operation until currentPage >= totalPageCount, merging items. Requires items in the selection set.
Max Pages	Safety limit for Return All (default 50)
Split Items	Emits each list element as its own n8n item
Ignore GraphQL Errors	Passes responses containing errors downstream instead of failing

99 of the 329 queries are paginated and work with Return All.

Error handling

The Enerflo API returns HTTP 200 with a populated errors array on failure.
The node treats that as a node failure by default, so bad requests surface in
n8n rather than flowing downstream as empty successes. Set Ignore GraphQL
Errors if you'd rather handle them yourself.

Regenerating the schema

The Enerflo schema changes without notice. operations.json is generated from a
live introspection:

ENERFLO_TOKEN=your_token ENERFLO_ORG=yourcompany npm run introspect
npm run generate

introspect writes introspection.json; generate reads it if present, so
rebuilds need no network access. Delete it to force a fresh pull.

The generator uses getIntrospectionQuery() and buildClientSchema(), so
argument types are rendered from the schema object and cannot be truncated by
nesting depth.

A weekly GitHub Action (.github/workflows/schema-drift.yml) re-introspects and
opens a PR when the manifest changes. It needs ENERFLO_ENDPOINT,
ENERFLO_TOKEN, and ENERFLO_ORG as repository secrets.

Development

npm install
npm test
npm run build

The test suite parses every generated operation and asserts each produces
exactly one root field.

Changes in 0.2.0

Fixed: Query and Mutation modes sent malformed operations. The operation
name and selection set were concatenated with nothing between them, so arguments
were never interpolated and variables never declared. fetchDeal with a nested
selection produced query { fetchDeal finalizedProposal { … } } — the operation
requested with no arguments and no selection set, and the selection set promoted
to a sibling root field. This parsed as valid GraphQL, so it failed at execution
with a server error rather than a validation message. Custom GraphQL mode was
unaffected.

Schema refreshed. The manifest had drifted: 329 queries and 342 mutations
now, up from 307 and 328. Newly available are the Aurora design integration
(createAuroraDesign, importAuroraProject, syncAuroraDesign,
requestAuroraDesignChanges, approveAuroraRequest, and others), raw finance
passthrough (fetchRawFinanceProductsList, sendRawFinanceApplication,
fetchRawFinanceStipulations, and others), battery recommendations, and
proposal selection (selectProposal, unselectProposal,
restartProposalSelection).

Breaking: assembleDocfloPacketComposite no longer exists in the schema —
it appears to have been replaced by captureDocfloPacketCompositePdf. Any
workflow referencing the old name needs updating.

Also in this release:

• Credential authentication now actually applies. The authenticate block was
  previously dead code, because execute() used helpers.httpRequest (which
  does not apply credentials) and rebuilt the headers by hand.
• Org Subdomain is now marked required — it is what routes to your tenant.
• Added a credential test.
• GraphQL errors returned with HTTP 200 now fail the node.
• Malformed Variables JSON raises an error instead of silently becoming {}.
• Missing required arguments are caught before the request is sent.
• Errors use NodeOperationError / NodeApiError so they carry node context.
• Operations returning a scalar (25 of them) no longer get an invalid selection
  set.
• Added Return All pagination, Split Items, and Ignore GraphQL Errors.
• Node is usable as an AI Agent tool.
• n8n-workflow moved from dependencies to peerDependencies.
• Fixed the build copying icons to the wrong directory, which left the node
  without its icon.
• Added repository metadata, a codex file, and a test suite.
• Schema generator rewritten on buildClientSchema, fixing truncated argument
  type-refs and recording return types and pagination shape.

License

MIT