v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Employee Payment Method

Update an employee bank account

Updates an employee bank account.

scope: employee_payment_methods:write

put/v1/employees/{employee_id}/bank_accounts/{bank_account_uuid}

Path parameters

employee_idstring required

The UUID of the employee

bank_account_uuidstring required

The UUID of the bank account

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

Success

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