Accounts

Create a new bank account

Create a new fiat bank account for your workspace, tenant, or counterparty.

Security: The bank_account_number field is encrypted and stored securely in a vault. It will never be returned in API responses.

Ownership: Use tenant_id OR counterparty_id to link the account. Omit both for a workspace-level account.

post/v1/accounts/banks

Request

Base URL
https://api.tesser.xyz
Auth
HTTP bearer
TypeScript
https://skmtc.dev/tesser/apis/tesser-api/docs/v1/accounts/banks/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

tenant_idstring uuid nullable

Tenant ID (mutually exclusive with counterparty_id). Links this account to a specific tenant.

counterparty_idstring uuid nullable

Counterparty ID (mutually exclusive with tenant_id). Links this account to a specific counterparty.

namestring required

Human-readable name for the bank account

bank_namestring required

Name of the financial institution

bank_code_typestring required

Type of bank code (e.g., SWIFT, BIC, IBAN, ROUTING, SORT_CODE)

bank_identifier_codestring required

Bank identifier code value

bank_swift_codestring nullable

SWIFT code

bank_account_numberstring required

Bank account number. SECURE FIELD: Encrypted and stored in vault, never returned in responses. Required in API request.

Example request

{
  "tenant_id": "550e8400-e29b-41d4-a716-446655440002",
  "counterparty_id": "660e8400-e29b-41d4-a716-446655440003",
  "name": "Operating Account - EU",
  "bank_name": "Chase Bank",
  "bank_code_type": "SWIFT",
  "bank_identifier_code": "CHASUS33",
  "bank_swift_code": "CHASUS33XXX",
  "bank_account_number": "1234567890"
}

Response

Bank account created successfully

Changes

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