Create an account

Authorizations

Authorization

string

header

required

JWT Authorization header using the Bearer scheme. Enter 'Bearer ' [space] and then your token in the text input below.

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.

Body

organization_id

string

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:

unknown,

business

business_profile

object

required

business_profile.name

string

required

The operating or trade name of the business.

business_profile.website

string

required

URL of the business's primary marketing website.

business_profile.legal_name

string | null

The official registered name of the business.

business_profile.description

string | null

A brief description of the business and its products or services.

business_profile.use_case

string | null

A description of how the business intends to use Straddle's services.

business_profile.tax_id

string | null

The business's tax identification number (e.g., EIN in the US).

business_profile.phone

string | null

The primary contact phone number for the business.

business_profile.address

object

business_profile.industry

object

business_profile.support_channels

object

access_level

enum<string>

required

The desired access level for the new account. Possible values: 'managed', 'standard'.

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

201

text/plain

Created

meta

object

required

response_type

enum<string>

required

Indicates the type of data returned.

Available options:

object,

array,

error,

none

data

object

required

data.id

string

required

Unique identifier for the account.

data.organization_id

string

required

The unique identifier of the organization this account belongs to.

data.type

enum<string>

required

The type of account (e.g., 'individual', 'business').

Available options:

unknown,

business

data.status

enum<string>

required

The current status of the account (e.g., 'active', 'inactive', 'pending').

Available options:

unknown,

created,

onboarding,

active,

rejected,

inactive

data.status_detail

object

required

data.access_level

enum<string>

required

The access level granted to the account. This is determined by your platform configuration. Possible values: 'managed', 'standard'.

Available options:

standard,

managed

data.business_profile

object

data.business_profile.name

string

required

The operating or trade name of the business.

data.business_profile.website

string

required

URL of the business's primary marketing website.

data.business_profile.legal_name

string | null

The official registered name of the business.

data.business_profile.description

string | null

A brief description of the business and its products or services.

data.business_profile.use_case

string | null

A description of how the business intends to use Straddle's services.

data.business_profile.tax_id

string | null

The business's tax identification number (e.g., EIN in the US).

data.business_profile.phone

string | null

The primary contact phone number for the business.

data.business_profile.address

object

data.business_profile.industry

object

data.business_profile.support_channels

object

data.capabilities

object

data.settings

object

data.terms_of_service

object

data.metadata

object | null

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

data.external_id

string | null

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

data.created_at

string | null

Timestamp of when the account was created.

data.updated_at

string | null

Timestamp of the most recent update to the account.

Fundamentals

SDKs

Customers

Bridge

Paykeys

Charges

Payouts

Funding

Embed

Authorizations

Headers

Body

Response