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
Key | Datatype | Required | Description |
---|---|---|---|
X-Gusto-API-Version | string | Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used. | |
Content-Type | string | ||
Accept | string |
RESPONSES
status: Created
{"uuid":"1263eae5-4411-48d9-bd6d-18ed93082e65","company_uuid":"e2c4c0ce-2986-48b9-86cf-ec27f6ed9a36","account_type":"Checking","routing_number":"851070439","hidden_account_number":"XXXX4087","verification_status":"verified","verification_type":"bank_deposits","name":"Employer Funding Account"}