---
title: "Create a contractor bank account"
method: POST
path: "/v1/contractors/{contractor_uuid}/bank_accounts"
tags: ["Contractor Payment Method"]
---

# Create a contractor bank account

`POST /v1/contractors/{contractor_uuid}/bank_accounts`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/contractors/{contractor_uuid}/bank_accounts`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/gusto/apis/gusto-api/docs/v1/contractors/:contractor_uuid/bank_accounts/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a contractor bank account.

Note: We currently only support one bank account per contractor. Using this endpoint on a contractor who already has a bank account will just replace it.

scope: `contractor_payment_methods:write`

## Path parameters

- `contractor_uuid` string, required

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Request body

- ContractorBankAccountCreateRequestBody
  - `name` string, required: Name for the bank account
  - `routing_number` string, required: The bank account's routing number
  - `account_number` string, required: The bank account's account number
  - `account_type` 'Checking' | 'Savings', required: Bank account type

## Response `201`

Example response

- ContractorBankAccount
  - `uuid` string, required: UUID of the bank account
  - `contractor_uuid` string, required: UUID of the contractor
  - `account_type` 'Checking' | 'Savings', required: Bank account type
  - `name` string, required: Name for the bank account
  - `routing_number` string, required: The bank account's routing number
  - `hidden_account_number` string, required: Masked bank account number

## Other responses

- `404`: Not Found The requested resource does not exist. Make sure the provided UUID is valid.
- `422`: Unprocessable Entity This may happen when the body of your request contains errors such as `invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the [Errors Categories](https://docs.gusto.com/embedded-payroll/docs/error-categories) guide for more details.

---

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