Addresses

Create a new external address

Creates a non-custodial address (EOA) for the specified account.

post/accounts/{account_id}/addresses/external

Request

  • Base URL
    https://api.brale.xyz
  • Auth
    HTTP bearer

Path parameters

account_idstring ksuid required
Example:2VcUIIsgARwVbEGlIYbhg6fGG57

The ID of the account

Headers

Idempotency-Keystring required

A unique string used to prevent duplicate operations. Each POST request must use a new idempotency key. Use a UUIDv4 string. Example: idemp-123e4567-e89b-12d3-a456-426614174000

Request body

OR

Example request

{
  "name": "Company External EVM Address",
  "address": "0xb518d4d6221d9a41d23d71cbce8e106e7aab8f9b",
  "transfer_types": [
    "solana"
  ]
}

Response

External address successfully created

idstring ksuid
namestring nullable
ownerstring
statusstring
ownershipstring
createdstring date-time
transfer_typesstring[]
account_numberstring

Returned masked (e.g. ****7890).

account_type'checking' | 'savings'
needs_updateboolean
last_updatedstring date-time
routingNumberstring

Note: this single field is currently returned in camelCase (routingNumber) while all other fields use snake_case.

Example response

{
  "id": "2VcUIIsgARwVbEGlIYbhg6fGG57",
  "name": "checking 7890",
  "owner": "Jane Doe",
  "status": "active",
  "ownership": "customer-owned",
  "bank_address": {
    "street_line_1": "100 Example St",
    "street_line_2": "Suite 500",
    "city": "Springfield",
    "state": "CA",
    "zip": "90001",
    "country": "US"
  },
  "beneficiary_address": {
    "street_line_1": "100 Example St",
    "street_line_2": "Suite 500",
    "city": "Springfield",
    "state": "CA",
    "zip": "90001",
    "country": "US"
  },
  "created": "2026-06-02T20:01:02.226850Z",
  "transfer_types": [
    "ach_credit"
  ],
  "account_number": "****7890",
  "account_type": "checking",
  "last_updated": "2026-06-02T20:01:03.321461Z",
  "routingNumber": "063108680"
}

Changes

No recorded changes to this operation across all 1 revision of this API.