API tutorials
Accounts
Open a subledger
what you will learn ✅ how to o pen a subledger (also called a subaccount ) you can create a subledger a s ubledger under any master account, such as a checking or savings account subledgers also support a beneficiary profile for storing additional data such as the name and address associated with the subledger your integration manager will assist you with any questions related to the data used to populate these fields, as they can vary by use case and program once opened, the subledger is ready within a few seconds if you are new to subledgers we recommend you read the subledgers before starting this tutorial the tutorial assumes you have a knowledge of apis and how they work refer to structure for more details the tutorial uses these api endpoints api description post /core/v1/dda/subaccounts o pens a subledger under a master account before you begin make sure you have quickstart master account number of the account under which you want to create the subledger title for the account accounts, cards and payment events for the following webhook event webhook description core subaccount opened subledger (subaccount) was opened open a subledger this tutorial shows you how to open a subledger for a master account you will open an account for jerry penn , whose master account number is 2819503463 to o pen a subledger call post /core/v1/dda/subaccounts for this call, the master account number and the title (name on the subledger) are required typically you use the partner name for the subledger title post /core/v1/dda/subaccounts request curl location 'https //sandbox crbcos com/core/v1/dda/subaccounts' \\ \ header 'idempotency key 3392de17 6e92 4999 b943 cad5f19b1629' \\ \ data '{ "masteraccountnumber" "2819503463", "title" "jerry penn", "customerid" "53c34cf0 4cd2 4768 937b b30000dffdca", "beneficiary" { "firstname" "jerry" , "lastname" "penn", "streetaddress1" "12 main st", "city" "new york", "state" "ny", "postalcode" "10001", "countrycode" "us" } } ' a successful api call returns a json response with the details of the new account post /core/v1/dda/subaccounts response { "accountnumber" "302022615264", "accounttype" "deposit", "status" "active", "ledgertype" "passthrough", "producttype" "checking", "title" "jerry penn", "currentbalance" 0, "availablebalance" 0, "holdamount" 0, "transactioncount" 0, "creditlimit" 0, "currency" "usd", "openedat" "2025 06 24t03 05 04 7952946 04 00", "masteraccountnumber" "2819503463", "customerid" "53c34cf0 4cd2 4768 937b b30000dffdca", "beneficiary" { "firstname" "jerry", "lastname" "penn", "streetaddress1" "12 main st", "city" "new york", "state" "ny", "postalcode" "10001", "countrycode" "us" }, "partnerid" "cd9c12f4 7691 424a b38b af5b0134c611", "lastmaintenanceat" "2025 06 24t03 05 04 7952946 04 00", "productid" "83bed086 8182 4151 a1e3 af5b01362783", "lastmodifiedat" "2025 06 24t03 05 04 8043224 04 00" } the accountnumber field provides the account number for the new subledger the core subaccount opened webhook event fires when the account is open sample webhook event { "id" "7dffc503 e24b 4fdd 96c3 b2e20129aa6d", "eventname" "core subaccount opened", "status" "pending", "partnerid" "cd9c12f4 7691 424a b38b af5b0134c611", "createdat" "2025 06 24t03 05 04 8043224 04 00", "resources" \[ "core/v1/dda/subaccounts/302022615264" ], "details" \[ { "subaccountnumber" "302022615264", "masteraccountnumber" "2819503463", "accounttype" "deposit", "status" "active", "title" "jerry penn", "clientidentifier" null } ] }