Create Bank Account

POST	https://api.sfox.com/v1/user/bank

Link an end user's bank account to their sFOX account.

---

Request

• Requires a User Auth Token for authentication. Requests attempted using an Connect API Key will result in an error.

• sFOX accounts only support one linked bank account at a time. If you would like to add a different bank, you must disconnect the currently linked bank.

Body Parameters

Name	Type	Description
type required	string	Whether the bank account is for an individual or corporation. Possible values: individual or corporate
bankAccountType required	string	Whether the bank account is a checking or savings account. Possible values: checking or savings
isInternational required	boolean	If the bank account is from an international bank. (US = False, International = True)
accountnumber required	string	Account number of the bank account.
routingnumber	string	Routing number of the bank. Required if isInternational = False
swiftnumber	string	SWIFT number of the bank. Required if isInternational = True
enableWires required	boolean	Whether the bank account is enabled to process wire transfers.
firstname required	string	First name on bank account. If type = corporate, specify the first name of the person who is the primary owner of the account.
lastname required	string	Last name on bank account. If type = corporate, specify the last name of the person who is the primary owner of the account.
name	string	Name of the business on the bank account. Required if type = corporate
bankCurrency	string	Currency code that the bank account transacts in. e.g. usd
bankname	string	Name of the bank. Required if isInternational = True
wireInstructions	string	Memo/correspondent bank/for further credit. Only applicable if isInternational = True
wireRoutingnumber	string	Routing number for wire transactions. Required if isInternational = False

Example Requests

Shell

curl -X POST \
  -H 'Content-type: application/json' \
  -H "Authorization: Bearer ${USER_AUTH_TOKEN}" \
  --data '{ "accountnumber": "123456789",
          "bankAccountType": "checking",
          "bankCurrency": "usd",
          "enableWires": true,
          "firstname": "Sean",
          "isInternational": false,
          "lastname": "Fox",
          "name": "Sean Fox",
          "routingnumber": "987654321",
          "type": "individual",
          "wireRoutingnumber": "987654321" }'  \
  'https://api.sfox.com/v1/user/bank'

NodeJS

Python

Request Body Examples

Individual US Bank

{
    "accountnumber": "123456789",
    "bankAccountType": "checking",
    "bankCurrency": "usd",
    "enableWires": true,
    "firstname": "Sean",
    "isInternational": false,
    "lastname": "Fox",
    "name": "Sean Fox",
    "routingnumber": "987654321",
    "type": "individual",
    "wireRoutingnumber": "987654321"
}

Individual International Bank

Corporate US Bank

Corporate International Bank

Responses

200: OK

{
    "usd": [
        {
            "id": "68983724-00da-11ef-862d-026c8f2aefd1",
            "status": "active",
            "requires_verification": 0,
            "requires_support": 0,
            "routing_number": "*****5821",
            "account_number": "*****14",
            "name1": "Sean Fox",
            "currency": "usd",
            "type": "checking",
            "bank_name": "US BANK NA",
            "ach_enabled": false,
            "international_bank": false,
            "ref_id": "aY1nN",
            "wire_withdrawal_fee": 30
        }
    ]
}