Skip to main content
POST
Create bank account

Authorizations

Authorization
string
header
required

Application (M2M) OAuth2 access token (client credentials).

Headers

X-Organization-ID
string<uuid>

ID of the organization to perform this operation on behalf of. Required for BANK and PLATFORM app token callers targeting a specific organization. If omitted, the request uses the authenticated caller's own organization. Must be a valid non-empty UUID. Present but malformed values return 400.

Body

Request model for creating a new bank account.

nickname
string
required

The nickname for the new bank account.

bankAccountNumber
null | string

An optional bank account number to assign to the new account. When omitted, Tesouro generates one. Only available to providers explicitly approved by the bank; the value is validated against the bank's account number rules and rejected if it does not conform.

bankAccountReference
null | string

An optional reference identifier to associate with the bank account. Can be used to store a Platform's or VSP's internal account identifier. Must be alphanumeric (letters, numbers, hyphens, underscores, and dots) and max 50 characters.

Response

Bank account created successfully.

Response model for a bank account.

id
string<uuid>
required

Unique identifier for the bank account.

accountNumber
string
required

Masked account number.

createdDateTime
string<date-time>
required

The UTC timestamp when the bank account was created.

routingNumber
string
required

Bank routing number.

status
enum<string>
required

The status of the bank account.

Available options:
ACTIVE,
CLOSED
bankAccountReference
null | string

Reference identifier associated with the bank account.

nickname
null | string

Nickname for the bank account.