Actions81
- Users Actions
- Organizations Actions
- Representatives Actions
- Bridge Actions
- Platforms Actions
- Tools Actions
- User Invites Actions
- Customers Actions
- Paykeys Actions
- Reports Actions
- Charge Actions
- Funding Events Actions
- Payments Actions
- Payout Actions
- Accounts Actions
- Get Account By Id
- put__v1_accounts_account_id
- Create Account
- get__v1_accounts
- post__v1_accounts_account_id_onboard
- post__v1_accounts_account_id_simulate
- patch__v1_internal_accounts_account_id
- get__v1_internal_accounts_account_id
- patch__v1_internal_accounts_account_id_status
- get__v1_internal_accounts_account_id_settings
- Capability Requests Actions
- Linked Bank Accounts Actions
Overview
This node integrates with the Straddle API to create a linked bank account via an internal bridge endpoint. Specifically, it performs a POST request to the /v1/internal/bridge/bank_account endpoint, allowing platforms to link a bank account by providing essential bank details.
Common scenarios for this node include:
- Platforms or financial applications that need to onboard user bank accounts securely.
- Automating the process of linking bank accounts for payment processing or verification.
- Internal workflows where bank account information must be registered or updated in the Straddle system.
Practical example:
- A fintech platform uses this node to register a user's checking or savings account by submitting routing and account numbers, enabling ACH payments or payouts.
Properties
| Name | Meaning |
|---|---|
| Straddle Account Id | (Optional) For platforms to specify an account ID to set the scope of the request; sent as header Straddle-Account-Id. |
| Request Id | (Optional) Client-generated identifier to trace and debug a single request; sent as header Request-Id. |
| Correlation Id | (Optional) Client-generated identifier to trace and debug a series of related requests; sent as header Correlation-Id. |
| Routing Number | (Required) The bank routing number of the account to link; sent in the request body. |
| Account Number | (Required) The bank account number to link; sent in the request body. |
| Account Type | (Required) The type of bank account; options are: Checking, Savings; sent in the request body. |
Output
The node outputs JSON data representing the response from the Straddle API after creating the linked bank account. This typically includes:
- Bank account details such as masked account number, routing number, account type, and bank name.
- Status details describing the current state of the linked bank account (e.g., verification status, messages).
- Verification information including status, method used, number of attempts, and completion timestamp.
No binary data output is indicated.
Dependencies
- Requires an API key credential for authenticating with the Straddle API.
- The base URL for requests is dynamically constructed based on the configured environment credential value.
- The node expects the Straddle API to be accessible and properly configured for the authenticated user.
Troubleshooting
- Missing required fields: Ensure that
Routing Number,Account Number, andAccount Typeare provided; otherwise, the API will reject the request. - Authentication errors: Verify that the API key credential is correctly set up and has necessary permissions.
- Invalid routing/account numbers: Double-check the bank details for correctness to avoid validation errors.
- Header misconfiguration: Optional headers like
Straddle Account Id,Request Id, andCorrelation Idshould be strings if used; invalid values may cause tracing issues. - API endpoint availability: Confirm network connectivity and that the Straddle API endpoint is reachable.
Links and References
- Straddle API Documentation (general reference for API endpoints and usage)
- n8n HTTP Request Node Documentation (for understanding how API calls are made within n8n)
This summary is based solely on static analysis of the provided source code and property definitions.