Create a company bank account

POST {{baseUrl}}/v1/companies/:company_id/bank_accounts

This endpoint creates a new company bank account.

Upon being created, two verification deposits are automatically sent to the bank account, and the bank account's verificationstatus is 'awaitingdeposits'.

When the deposits are successfully transferred, the verificationstatus changes to 'readyforverification', at which point the verify endpoint can be used to verify the bank account. After successful verification, the bank account's verificationstatus is 'verified'.

scope: company_bank_accounts:write

🚧 Warning

If a default bank account exists, it will be disabled and the new bank account will replace it as the company's default funding method.

Request Body

{"routing_number"=>"<string>", "account_number"=>"<string>", "account_type"=>"<string>"}

HEADERS

KeyDatatypeRequiredDescription
X-Gusto-API-VersionstringDetermines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.
Content-Typestring
Acceptstring

RESPONSES

status: Created

{&quot;uuid&quot;:&quot;1263eae5-4411-48d9-bd6d-18ed93082e65&quot;,&quot;company_uuid&quot;:&quot;e2c4c0ce-2986-48b9-86cf-ec27f6ed9a36&quot;,&quot;account_type&quot;:&quot;Checking&quot;,&quot;routing_number&quot;:&quot;851070439&quot;,&quot;hidden_account_number&quot;:&quot;XXXX4087&quot;,&quot;verification_status&quot;:&quot;verified&quot;,&quot;verification_type&quot;:&quot;bank_deposits&quot;,&quot;name&quot;:&quot;Employer Funding Account&quot;}