---
title: "Create a bank account"
method: POST
path: "/withdrawals/bank-accounts"
---

# Create a bank account

`POST /withdrawals/bank-accounts`

## Request

- Base URL: `https://api-sandbox.straitsx.com/v1`
- URL: `https://api-sandbox.straitsx.com/v1/withdrawals/bank-accounts`
- Auth: API key in header `X-XFERS-APP-API-KEY`

[Available in Production/Sandbox environment] Add a new bank account to the user's StraitsX account. Supports both Singapore and overseas bank accounts.

## Headers

- `X-XFERS-APP-API-KEY` string, required
- `X-PUBLIC-KEY-ID` string
- `X-TIMESTAMP` string
- `X-NONCE` string
- `X-SIGNATURE` string

## Request body

- object
  - `data` object
    - `attributes` object
      - `accountNo` string: Bank account number
      - `accountHolderName` string: Name of the bank account holder
      - `bank` string: Bank abbreviation
      - `swiftBic` string: Bank SWIFT/BIC code.<br>Regex: `/^[A-Z]{6}[A-Z0-9]{2}[A-Z0-9]{3}$/`<br><br><strong>Note:</strong> Must be uppercase
      - `intermediarySwiftBic` string: Intermediary SWIFT code.<br>Regex: `/^[A-Z]{6}[A-Z0-9]{2}[A-Z0-9]{3}$/`<br><br><strong>Note:</strong> Must be uppercase
      - `routingCode` string: Routing code
      - `bankName` string: Bank name
      - `billingAddress` object: Billing address
        - `country` string: Country code
        - `line1` string: Address line 1
        - `line2` string: Address line 2
        - `line3` string: Address line 3
        - `city` string: City
        - `postalCode` string: Postal code

## Response `201`

201

- object
  - `data` object
    - `id` string: Bank account ID.
    - `type` string: Request type.
    - `attributes` object
      - `accountHolderName` string: Name of the bank account holder.
      - `accountNo` string: Bank account number.
      - `routingCode` unknown
      - `bank` string: Bank abbreviation.
      - `swiftBic` string: Bank SWIFT/BIC code.
      - `intermediarySwiftBic` unknown
      - `status` string: Bank account status.
      - `createdAt` string: Timestamp when the bank account was created.
      - `updatedAt` string: Timestamp when the bank account was last updated.

---

[API](https://skmtc.dev/straitsx/apis/straitsx-sandbox-base-url.md) - [All operations](https://skmtc.dev/straitsx/apis/straitsx-sandbox-base-url/llms.txt) - [OpenAPI document](https://skmtc.dev/straitsx/apis/straitsx-sandbox-base-url/revisions/d17239d67150?raw)
