Create Outbound Brokerage Account

Create Outbound Brokerage Account

POST {{Environment_URL}}/customers/v1/partner/physical/:cpf/investmentBroker

This mutation registers a new brokerage account for investment operations. Brokerage accounts are required for executing investment broker transactions and transferring funds to financial institutions.

Headers

Name
Value

Authorization

Bearer <token>

client-key

123ABCD456

Path Params

Name
Example Value

cpf

123.456.789-00

Request Body

Parameter
Description
Type
Required
Example

account

The brokerage bank account information

Object

Yes

-

→ bankName

The name of the brokerage's bank

String

Yes

"Multy Bank"

→ name

The legal name of the brokerage institution

String

Yes

"Nice Name"

→ number

The brokerage account number

String

Yes

"123456789"

→ bankCountry

The country of the bank (ISO 3166-1 alpha-3)

String

Yes

"USA"

→ currency

The account currency (ISO 4217 alpha-3)

String

Yes

"USD"

→ code

Array of routing codes

Array[Object]

Yes

-

→ → option

Routing code type (e.g., ACH, SWIFT_BIC)

String

Yes

"ACH"

→ → value

Routing code value

String

Yes

"021000021"

address

The physical address of the brokerage

Object

Yes

-

→ country

Country code (ISO 3166-1 alpha-2)

String

Yes

"US"

→ zipCode

Postal code

String

Yes

"08000000"

→ state

State or province

String

Yes

"SP"

→ city

City name

String

Yes

"Sâo Paulo"

→ neighborhood

Neighborhood or district

String

Yes

"Vila Olímpia"

→ street

Street address

String

Yes

"Rua das orquídeas"

→ number

Address number

Integer

Yes

123

→ complement

Additional address information

String

No

"Ap 130"

bankCode

The bank code (if applicable)

String

No

""

currency

Transaction currency (ISO 4217 alpha-3)

String

Yes

"USD"

fullName

Legal name of the brokerage institution

String

Yes

"Multy Bank"

personType

Legal entity type

String

Yes

"LEGAL"

subType

Purpose of the account

String

Yes

"INVESTMENTS"

Validation Rules

  • personType must be LEGAL for brokerage accounts

  • subType must be INVESTMENTS for investment operations

  • bankCountry and currency must be compatible

  • Routing codes must follow currency-specific validation rules

Body

Response