Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Use your Straddle API Key in the Authorization header as Bearer to authorize API requests.

Headers

request-id
string

Optional client generated identifier to trace and debug a request.

correlation-id
string

Optional client generated identifier to trace and debug a series of requests.

idempotency-key
string

Optional client generated value to use for idempotent requests.

Required string length: 10 - 40

Body

organization_id
string<uuid>
required

The unique identifier of the organization related to this account.

account_type
enum<string>
required

The type of account to be created. Currently, only business is supported.

Available options:
business
business_profile
object
required
access_level
enum<string>
required

The access level granted to the account. This is determined by your platform configuration. Use standard unless instructed otherwise by Straddle.

Available options:
standard,
managed
metadata
object | null

Up to 20 additional user-defined key-value pairs. Useful for storing additional information about the account in a structured format.

external_id
string | null

Unique identifier for the account in your database, used for cross-referencing between Straddle and your systems.

Response

Created

meta
object
required

Metadata about the API request, including an identifier and timestamp.

response_type
enum<string>
required

Indicates the structure of the returned content.

  • "object" means the data field contains a single JSON object.
  • "array" means the data field contains an array of objects.
  • "error" means the data field contains an error object with details of the issue.
  • "none" means no data is returned.
Available options:
object,
array,
error,
none
data
object
required