v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

Employee Payment Method

Create an employee bank account

Creates an employee bank account. An employee can have multiple bank accounts. Note that creating an employee bank account will also update the employee's payment method.

scope: employee_payment_methods:write

post/v1/employees/{employee_id}/bank_accounts

Path parameters

employee_idstring required

The UUID of the employee

Headers

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

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Request body

routing_numberstring required

The bank routing number (nine digits).

account_numberstring required

The bank account number.

account_type'Checking' | 'Savings' required

The bank account type.

namestring required

A name for the bank account (e.g. "Primary Checking").

Example request

{
  "routing_number": "266905059",
  "account_number": "5809431207",
  "account_type": "Checking",
  "name": "BoA Checking Account"
}

Response

Created

uuidstring required

UUID of the bank account

employee_uuidstring

UUID of the employee

account_type'Checking' | 'Savings'

Bank account type

namestring

Name for the bank account

routing_numberstring

The bank account's routing number

hidden_account_numberstring

Masked bank account number