---
title: "Create Bank Account"
method: POST
path: "/print-mail/v1/bank_accounts"
tags: ["Bank Accounts"]
---

# Create Bank Account

`POST /print-mail/v1/bank_accounts`

Create a bank account. A US bank account is created by setting `bankCountryCode` to `US` and providing `accountNumber` and `routingNumber`. A canadian bank account can be created by specifying `bankCountryCode` as `CA` and setting `accountNumber`, `routeNumber`, and `transitNumber` accordingly.

You must specify _either_ `signatureImage` or `signatureText`. The image can be supplied as either a URL or a multipart file upload.

## Request body

- union
  - BankAccountCreateSignatureText
    - `bankName` string, required — The name of the bank.
    - `bankPrimaryLine` string — The primary address line of the bank.
    - `bankSecondaryLine` string — The secondary address line of the bank.
    - `bankCountryCode` 'CA' | 'US', required — Countries typically have different bank account formats and standards. These are the countries which PostGrid's bank accounts API supports.
    - `accountNumber` string, required — The account number of the bank account.
    - `routingNumber` string — The routing number of the bank account (for US).
    - `transitNumber` string — The transit number of the bank account (for CA).
    - `routeNumber` string — The route number of the bank account (for CA).
    - `caDesignationNumber` string — The designation number of the bank account (for CA).
    - `description` string — An optional string describing this resource. Will be visible in the API and the dashboard.
    - `metadata` object — See the section on Metadata.
    - `signatureText` string, required — The signature text of the bank account.
  - BankAccountCreateSignatureImageURL
    - `bankName` string, required — The name of the bank.
    - `bankPrimaryLine` string — The primary address line of the bank.
    - `bankSecondaryLine` string — The secondary address line of the bank.
    - `bankCountryCode` 'CA' | 'US', required — Countries typically have different bank account formats and standards. These are the countries which PostGrid's bank accounts API supports.
    - `accountNumber` string, required — The account number of the bank account.
    - `routingNumber` string — The routing number of the bank account (for US).
    - `transitNumber` string — The transit number of the bank account (for CA).
    - `routeNumber` string — The route number of the bank account (for CA).
    - `caDesignationNumber` string — The designation number of the bank account (for CA).
    - `description` string — An optional string describing this resource. Will be visible in the API and the dashboard.
    - `metadata` object — See the section on Metadata.
    - `signatureImage` string, uri, required — Link to signature image which PostGrid will download and apply to cheques created with this bank account.
  - BankAccountCreateSignatureImageFile
    - `bankName` string, required — The name of the bank.
    - `bankPrimaryLine` string — The primary address line of the bank.
    - `bankSecondaryLine` string — The secondary address line of the bank.
    - `bankCountryCode` 'CA' | 'US', required — Countries typically have different bank account formats and standards. These are the countries which PostGrid's bank accounts API supports.
    - `accountNumber` string, required — The account number of the bank account.
    - `routingNumber` string — The routing number of the bank account (for US).
    - `transitNumber` string — The transit number of the bank account (for CA).
    - `routeNumber` string — The route number of the bank account (for CA).
    - `caDesignationNumber` string — The designation number of the bank account (for CA).
    - `description` string — An optional string describing this resource. Will be visible in the API and the dashboard.
    - `metadata` object — See the section on Metadata.
    - `signatureImage` string, byte, required — A PNG or JPEG file which PostGrid will apply to checks created with this bank account.

## Response `201`

The request has succeeded and a new resource has been created as a result.

- BankAccount
  - `object` 'bank_account', required — Always `bank_account`.
  - `bankName` string, required — The name of the bank.
  - `bankPrimaryLine` string — The primary address line of the bank.
  - `bankSecondaryLine` string — The secondary address line of the bank.
  - `bankCountryCode` 'CA' | 'US', required — Countries typically have different bank account formats and standards. These are the countries which PostGrid's bank accounts API supports.
  - `accountNumber` string, required — The account number of the bank account.
  - `routingNumber` string — The routing number of the bank account (for US).
  - `transitNumber` string — The transit number of the bank account (for CA).
  - `routeNumber` string — The route number of the bank account (for CA).
  - `caDesignationNumber` string — The designation number of the bank account (for CA).
  - `id` string, required — A unique ID prefixed with bank_account_
  - `description` string — An optional string describing this resource. Will be visible in the API and the dashboard.
  - `metadata` object — See the section on Metadata.
  - `live` boolean, required — `true` if this is a live mode resource else `false`.
  - `createdAt` string, date-time, required — The UTC time at which this resource was created.
  - `updatedAt` string, date-time, required — The UTC time at which this resource was last updated.
  - `signatureText` string — The signature text PostGrid uses to generate a signature for cheques created using this bank account. This is omitted if `signatureImage` is present.
  - `signatureImage` string, uri — A signed link to the signature image uploaded when this bank account was created. This is omitted if `signatureText` is present.

## Other responses

- `400` — The server could not understand the request due to invalid syntax.
- `401` — Access is unauthorized.
- `404` — The server cannot find the requested resource.
- `422` — Client error
- `429` — Client error
- `500` — Server error

---

[API](https://skmtc.net/postgrid/apis/postgrid-print-mail-api.md) · [All operations](https://skmtc.net/postgrid/apis/postgrid-print-mail-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/postgrid/postgrid-print-mail-api/revisions/6bb9d268c5d1/schema)