---
title: "Create a bank external account"
method: POST
path: "/bank-accounts"
tags: ["External Bank Account"]
---

# Create a bank external account

`POST /bank-accounts`

## Request

- Base URL: `https://api.enterprise.airtm.com/v2`
- URL: `https://api.enterprise.airtm.com/v2/bank-accounts`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/airtm/apis/airtm-enterprise-api-v2/docs/bank-accounts/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a US or EUR bank external account for the enterprise.

## Request body

- CreateBankExternalAccountRequest
  - `accountType` 'us_ach' | 'us_wire' | 'iban', required
  - `currency` 'USD' | 'EUR', required
  - `bankName` string, required: The name of the bank.
  - `accountOwnerName` string, required: The name of the account owner.
  - `businessName` string, required: The name of the business.
  - `address` object: The address of the business.
    - `country` string, required
    - `postalCode` string
    - `state` string, required
    - `city` string, required
    - `streetLine2` string
    - `streetLine1` string, required
  - `usAccount` object: The account details for US ACH or US Wire accounts.
    - `checkingOrSavings` 'checking' | 'savings'
    - `routingNumber` string, required
    - `accountNumber` string, required
  - `iban` object: The IBAN details for IBAN accounts.
    - `country` string, required
    - `bic` string, required
    - `accountNumber` string, required
  - `swift` object: Optional: The SWIFT details for IBAN account. When accountType is 'iban', the swift field is optional, meaning you can include it to provide additional SWIFT-specific information (like business context, purpose of funds, etc.), but it's not required for basic IBAN account creation.
    - `shortBusinessDescription` string, required
    - `purposeOfFunds` string[], required
    - `category` 'client' | 'parent_company' | 'subsidiary' | 'supplier', required
    - `address` object, required
      - `country` string, required
      - `postalCode` string
      - `state` string, required
      - `city` string, required
      - `streetLine2` string
      - `streetLine1` string, required
    - `account` object, required
      - `country` string, required
      - `bic` string, required
      - `accountNumber` string, required

## Response `200`

Ok

- BankExternalAccountResponse
  - `id` string, required: The id of the bank external account.
  - `accountType` 'us_ach' | 'us_wire' | 'iban', required
  - `currency` 'USD' | 'EUR', required
  - `bankName` string, required: The name of the bank.
  - `accountOwnerName` string, required: The name of the account owner.
  - `businessName` string, required: The name of the business.
  - `address` object: The address of the business.
    - `country` string, required
    - `postalCode` string
    - `state` string, required
    - `city` string, required
    - `streetLine2` string
    - `streetLine1` string, required
  - `usAccount` object: The account details for US ACH or US Wire accounts.
    - `checkingOrSavings` string
    - `routingNumber` string, required
    - `accountNumber` string, required
  - `iban` object: The IBAN details for IBAN accounts.
    - `country` string, required
    - `bic` string, required
    - `accountNumber` string, required
  - `swift` object: Optional: The SWIFT details for IBAN account. When accountType is 'iban', the swift field is optional, meaning you can include it to provide additional SWIFT-specific information (like business context, purpose of funds, etc.), but it's not required for basic IBAN account creation.
    - `shortBusinessDescription` string, required
    - `purposeOfFunds` string[], required
    - `category` string, required
    - `address` object, required
      - `country` string, required
      - `postalCode` string
      - `state` string, required
      - `city` string, required
      - `streetLine2` string
      - `streetLine1` string, required
    - `account` object, required
      - `country` string, required
      - `bic` string, required
      - `accountNumber` string, required
  - `createdAt` string, required: The date and time the bank external account was created.
  - `updatedAt` string, required: The date and time the bank external account was updated.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/airtm/apis/airtm-enterprise-api-v2.md) - [All operations](https://skmtc.dev/airtm/apis/airtm-enterprise-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/airtm/apis/airtm-enterprise-api-v2/revisions/c9ed13d4c5c0?raw)