---
title: "Create a Payable Bank Account"
method: POST
path: "/v1/users/{userId}/bankAccounts/payable"
tags: ["User Management"]
---

# Create a Payable Bank Account

`POST /v1/users/{userId}/bankAccounts/payable`

Create a payable bank account for the user

## Path parameters

- `userId` string, required

## Request body

- CreatePayableBankAccountRequest
  - `bankAccountDetails` PayableBankAccountDetails, required
    - `routingNumber` string, required — Bank account routing number
    - `accountNumber` string, required — Bank account number
    - `accountType` 'CHECKING' | 'SAVINGS', required — Bank account type
    - `accountHolderProfile` PayableAccountHolderProfile, required
      - `firstName` string, required — Account holder first name
      - `lastName` string, required — Account holder last name
      - `email` string, required — Account holder email

## Response `200`

Successful response

- CreatePayableBankAccountResponse
  - `status` ResponseStatus, required
    - `code` number
    - `desc` string
    - `messages` Message[]
      - `desc` string, required
      - `type` 'ERROR' | 'WARN' | 'INFO'
  - `data` CreatePayableBankAccountResponseData, required
    - `bankAccountId` string, required — Spinwheel identifier for newly created bank account
    - `userId` string, required — Spinwheel user id for which the bank account was created
    - `accountNumberLastFourDigits` string, required — Bank account last 4 digits
    - `accountType` 'CHECKING' | 'SAVINGS', required — Bank account type
    - `createdOn` number, required — Bank account created on timestamp
    - `updatedOn` number, required — Bank account updated on timestamp

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/spinwheel/apis/discover.md) · [All operations](https://skmtc.dev/spinwheel/apis/discover/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spinwheel/discover/revisions/55b90a2e1dd4/schema)