Skip to main content
POST
/
embedded-banking
/
v1
/
bank-accounts
Create a new bank account.
curl --request POST \
  --url https://api.sandbox.tesouro.com/embedded-banking/v1/bank-accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "nickname": "<string>",
  "bankAccountReference": "<string>",
  "beneficialOwnerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "accountNumber": "<string>",
  "createdDateTime": "2023-11-07T05:31:56Z",
  "routingNumber": "<string>",
  "status": "ACTIVE",
  "bankAccountReference": "<string>",
  "nickname": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.tesouro.com/llms.txt

Use this file to discover all available pages before exploring further.

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.

​
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.

​
beneficialOwnerId
null | string<uuid>

The ID of a beneficial owner to use for VSP APP token bank account creation. Required for VSP APP token callers (no user context). Not applicable when organizationId is provided by BANK or PLATFORM callers.

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.