VUZDevelopers

Create bank account

POST
/banking/businesses/{businessId}/accounts

Add a new bank account to a business.

Authorization

X-Api-Key<token>

Business API key, e.g. vuz_ab12cdef... Created via Settings → Integrations → API Keys. Unlike partner keys, a public API key's STRING does not encode its environment — isolation instead comes from a completely separate sandbox database: a key minted on the Sandbox server (above) only ever reads/writes sandbox data and can never see or affect production, regardless of what the key looks like.

In: header

Path Parameters

businessId*unknown

Business ID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/banking/businesses/{businessId}/accounts" \  -H "Content-Type: application/json" \  -d '{    "bankCode": 12,    "branchCode": 689,    "accountNumber": "123456789"  }'
{  "id": "550e8400-e29b-41d4-a716-446655440000",  "businessId": "550e8400-e29b-41d4-a716-446655440000",  "bankCode": 12,  "bankNameHe": "בנק הפועלים בע\"מ",  "bankShortName": "הפועלים",  "branchCode": 689,  "branchName": "דיזנגוף סנטר",  "branchAddress": "דיזנגוף 50, תל אביב",  "accountNumber": "123456789",  "accountName": "חשבון עסקי ראשי",  "isDefault": true,  "showOnDocuments": true,  "isActive": true,  "sortOrder": 0,  "accountHolderName": "יוסי כהן בע\"מ",  "currency": "ILS",  "iban": "IL620108310000000123456",  "swiftCode": "POLOILIT",  "notes": "string",  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z",  "displayString": "הפועלים | סניף 689 | חשבון 123456789",  "shortDisplay": "הפועלים 689/123456789"}