---
title: "Create a bank account payment account"
method: POST
path: "/v1/PaymentAccounts/bankaccount"
tags: ["PaymentAccounts"]
---

# Create a bank account payment account

`POST /v1/PaymentAccounts/bankaccount`

## Request

- Base URL: `https://restapi.rev.io`
- URL: `https://restapi.rev.io/v1/PaymentAccounts/bankaccount`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/rev-io/apis/rev-io-api/docs/v1/PaymentAccounts/bankaccount/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new payment account for bank accounts.

## Request body

- RevAppPostModelsBankAccount
  - `account_name` string, required: The name on the bank account.
  - `account_number` string: Bank account number. Required unless a token is supplied.
  - `token` string: A token indicating bank account information as received from a payment gateway. The account number may not be sent with it. Please note that the following gateways require a specific format: Authorize.net: "customer_profile_id::payment_profile_id"
  - `last_4` string: The last four digits of the bank account. Optional, and only allowed with a token. Recommended: some processors reject later updates to an account saved without it.
  - `email` string: Email address associated with the bank account.
  - `phone` string: Phone number associated with the bank account.
  - `routing_number` string: Bank routing number. Required unless a token or Canadian institution and transit numbers are supplied. Optional but recommended with a token: some processors reject later updates to an account saved without it.
  - `institution_number` string: Canadian bank institution number.
  - `transit_number` string: Canadian transit number.
  - `account_type` 'CHECKING' | 'SAVINGS', required: Indicates the type of bank account.
  - `bank_name` string: Bank name.
  - `check_number` string: Check number.
  - `customer_id` integer, required: Foreign identifier indicating the customer account associated with this payment method
  - `address_id` integer: Foreign identifier indicating the address associated with this payment method If no address is supplied, the billing address on the customer is used

## Response `201`

Created

- RevWebAPIModelsCreate
  - `ok` boolean
  - `id` integer

## Other responses

- `400`: BadRequest
- `500`: InternalServerError

## Changes

- **2026-11-03** `f175f5a3b11d`: 1 breaking, 24 info
  - request body became required
  - added the new optional request property `email` (media type: application/json)
  - added the new optional request property `email` (media type: text/json)
  - added the new optional request property `email` (media type: text/html)
  - …21 more

[Operation history](https://skmtc.dev/rev-io/apis/rev-io-api/changes/v1/PaymentAccounts/bankaccount/post.md)

---

[API](https://skmtc.dev/rev-io/apis/rev-io-api.md) - [All operations](https://skmtc.dev/rev-io/apis/rev-io-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rev-io/apis/rev-io-api/revisions/f175f5a3b11d?raw)