n8n-nodes-straddle v0.3.7

n8n-nodes-straddle

This is an n8n community node for interacting with the Straddle API. It provides operations for accounts, linked bank accounts, and other Straddle resources.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Resources

Installation

Follow these steps to install this node in your n8n instance:

npm install n8n-nodes-straddle

Or if you're using pnpm:

pnpm add n8n-nodes-straddle

Operations

This node is automatically generated from the Straddle API OpenAPI specification. It supports all endpoints defined in the API spec, including:

• All API operations as defined in the OpenAPI spec
• Automatic parameter validation
• Request/response handling
• Error handling

Credentials

This node uses bearer token authentication. You'll need to provide:

1. API Key - Your Straddle API key (used as a bearer token)
2. Environment - Choose from:
   • Production (production)
   • Sandbox (sandbox)
   • Internal (internal)

Compatibility

• Requires n8n version >= 1.0.0
• Node.js >= 18.10

Resources

• n8n community nodes documentation
• Straddle API documentation

Version history

0.2.0 - Fixed authentication to use Bearer token format; improved handling of nested objects in the schema; added schema validation and update tools 0.1.0 - Initial release

Features

This node provides access to the following Straddle API resources:

• Accounts
• Linked Bank Accounts
• Payments
• And more...

Each resource has various operations like create, read, update, etc.

Updating the API Schema

When the Straddle API changes, you'll need to update the schema file (nodes/straddle/straddle.json) and rebuild the node. Here's the workflow for updating the schema:

Option 1: Manual Update

1. Replace the nodes/straddle/straddle.json file with the updated schema
2. Validate the schema:

   pnpm run validate-schema

3. Rebuild the node:

   pnpm run build

Option 2: Automated Update

Use the all-in-one update command:

pnpm run update-schema

Option 3: Development Mode

During active development, you can watch for schema changes:

pnpm run watch-schema

This will automatically rebuild the node whenever the schema file changes.

Important Schema Structure Notes

For proper functionality, the schema should maintain references to component schemas. In particular:

• BusinessProfileV1 should reference nested components:
  • address should reference AddressV1
  • industry should reference IndustryV1
  • support_channels should reference SupportChannelsV1

This ensures that nested fields are properly displayed in the n8n UI.

License

MIT