Logo
GoCardless API API Documentation

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

 

Body PARAM

Key Datatype Required Description 



HEADERS

Key Datatype Required Description 




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" } } }



Curl
curl -X POST 'https://api-sandbox.gocardless.com/customer_bank_accounts' -d '{"customer_bank_accounts":{"country_code":"GB","account_holder_name":"$randomFullName","account_number":"55779911","branch_code":"200000","links":{"customer":"$randomFullName"}}}'

ENDPOINTS