Straddle icon

Straddle

Interact with Straddle API

Actions81

Overview

This node allows you to create a linked bank account associated with a specific Straddle account. It is useful in scenarios where you want to programmatically add bank accounts for payment processing, payouts, or ACH transfers within the Straddle platform. For example, a financial application could use this node to link a user's bank account to their Straddle account to enable direct deposits or withdrawals.

Properties

Name Meaning
Request Id Optional client-generated identifier to trace and debug a single request (sent as HTTP header).
Correlation Id Optional client-generated identifier to trace and debug a series of related requests (header).
Account Id The unique identifier of the Straddle account to associate this linked bank account with.
Bank Account JSON object containing detailed bank account information to be linked (e.g., routing number, account number, type).
Metadata Optional user-defined key-value pairs for custom metadata associated with the linked bank account.

Output

The node outputs JSON data representing the newly created linked bank account resource. This includes details such as:

  • Bank account details (routing number, masked account number, account type, bank name).
  • Status details describing the current state of the linked bank account.
  • Verification information including status, method used, attempts, and completion timestamp.
  • Any metadata associated with the linked bank account.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the Straddle API.
  • The base URL for API requests depends on the configured environment (e.g., sandbox or production).
  • The node uses standard HTTP headers and JSON payloads to communicate with the Straddle service.

Troubleshooting

  • Missing Required Fields: Ensure that Account Id and Bank Account JSON are provided and correctly formatted; otherwise, the API will reject the request.
  • Invalid Bank Account Data: Incorrect routing numbers or account numbers may cause verification failures.
  • Authentication Errors: Verify that the API key credential is valid and has appropriate permissions.
  • Header Issues: If using Request Id or Correlation Id, ensure they are unique strings to avoid tracing confusion.
  • API Environment Misconfiguration: Confirm the environment setting matches the intended Straddle environment (sandbox vs production).

Common error messages will typically relate to validation errors from the API or authentication failures. Reviewing the response message and reason fields in the output can help diagnose issues.

Links and References

Discussion