Create a Customer Bank Account

POST {{url}}/customer_bank_accounts

Please consider using the Billing Requests API instead of Customer Bank Accounts for any future integrations.

Creates a new customer bank account object.

There are three different ways to supply bank account details:

  • Local details
  • IBAN
  • Customer Bank Account Tokens

Note: Customer bank accounts can be created with local or international bank details. You can find the different local bank detail formats, and how they should be used with the GoCardless API here.

Create a customer bank account API Docs

Request Body

{"customer_bank_accounts"=>{"country_code"=>"GB", "account_holder_name"=>"{{$randomFullName}}", "account_number"=>"55779911", "branch_code"=>"200000", "links"=>{"customer"=>"{{customer}}"}}}

RESPONSES

status: Created

{"customer_bank_accounts":{"id":"BA000ZP5SP5WJ0","created_at":"2024-03-22T20:44:08.380Z","account_number_ending":"11","account_holder_name":"SHARON LYNCH","account_type":null,"bank_name":"BARCLAYS BANK PLC","currency":"GBP","country_code":"GB","metadata":{},"enabled":true,"links":{"customer":"CU0014DQPR6JJP"}}}