Straddle icon

Straddle

Interact with Straddle API
Join our community

Actions81

Overview

The "Create Account" operation under the "Accounts" resource allows users to create a new account within an organization using the Straddle API. This node is useful for automating the onboarding of business accounts, managing organizational structures, or integrating account creation into larger workflows such as CRM updates or financial system setups.

Typical use cases include:

  • Automatically creating business accounts when a new client signs up.
  • Setting up accounts with specific access levels and detailed business profiles.
  • Associating external identifiers for cross-referencing with internal databases.

Properties

Name Meaning
Request Id Optional client-generated identifier to trace and debug a single request. Sent as a header named request-id.
Correlation Id Optional client-generated identifier to trace and debug a series of related requests. Sent as a header named correlation-id.
Organization Id Required. The unique identifier of the organization to which this new account will belong.
Account Type Required. The type of account to be created. Options: unknown, business. Currently, only business is supported.
Business Profile Required. JSON object containing detailed business profile information including address, industry, and support channels. Must be valid JSON.
Access Level Required. Desired access level for the new account. Options: standard, managed.
Metadata Optional JSON object of user-defined key-value pairs for custom metadata associated with the account.
External Id Optional string representing a unique identifier for the account in your own database, used for cross-referencing between Straddle and your systems.

Output

The node outputs JSON data representing the newly created account's details as returned by the Straddle API. This includes all relevant account information such as identifiers, business profile, access level, metadata, status, and possibly verification and bank details if applicable.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with the Straddle API.
  • The base URL for API requests is dynamically set based on the configured environment (e.g., sandbox or production).
  • The node expects the input properties to be correctly formatted, especially JSON fields like business_profile and metadata.

Troubleshooting

  • Invalid JSON in Business Profile or Metadata: If the JSON provided in these fields is malformed, the API request will fail. Ensure that JSON strings are valid and properly escaped.
  • Missing Required Fields: Omitting required fields such as organization_id, account_type, business_profile, or access_level will cause errors. Double-check that all required inputs are provided.
  • Unsupported Account Type: Currently, only the business account type is supported. Using other values may result in API rejection.
  • API Authentication Errors: Ensure that the API key credential is correctly configured and has sufficient permissions.
  • Header Injection Issues: The optional request-id and correlation-id headers must be strings; invalid types might cause request failures.

Links and References

Discussion