;
};
Blnk enables you to create and link multiple balances to a single identity within your Ledger.
Any transaction record associated with a linked balance is also automatically mapped to the corresponding identity.
***
## Link an identity to a balance
To create a balance connected to an identity, include the `identity_id` of the identity you want to associate with the balance in the request body of the **create-balance** endpoint as shown below:
```bash cURL wrap theme={"system"}
curl -X POST "http://localhost:5001/balances" \
-H "X-blnk-key: " \
-H "Content-Type: application/json" \
-d '{
"ledger_id": "ldg_073f7ffe-9dfd-42ce-aa50-d1dca1788adc",
"identity_id": "idt_0501db5c-baf9-4be1-a931-f4bae7f3a41d",
"currency": "USD"
}'
```
```typescript TypeScript wrap theme={"system"}
const response = await blnk.LedgerBalances.create({
ledger_id: 'ldg_073f7ffe-9dfd-42ce-aa50-d1dca1788adc',
identity_id: 'idt_0501db5c-baf9-4be1-a931-f4bae7f3a41d',
currency: 'USD',
});
```
```go Go wrap theme={"system"}
balance, _, err := client.LedgerBalance.Create(blnkgo.CreateLedgerBalanceRequest{
LedgerID: "ldg_073f7ffe-9dfd-42ce-aa50-d1dca1788adc",
IdentityID: "idt_0501db5c-baf9-4be1-a931-f4bae7f3a41d",
Currency: "USD",
})
if err != nil {
log.Fatal(err)
}
fmt.Println("Balance Created:", balance.BalanceID)
```
```python Python wrap theme={"system"}
response = blnk.ledger_balances.create({
"ledger_id": "ldg_073f7ffe-9dfd-42ce-aa50-d1dca1788adc",
"identity_id": "idt_0501db5c-baf9-4be1-a931-f4bae7f3a41d",
"currency": "USD",
})
```
```java Java wrap theme={"system"}
ApiResponse response = blnk.ledgerBalances().create(
CreateLedgerBalance.create()
.ledgerId("ldg_073f7ffe-9dfd-42ce-aa50-d1dca1788adc")
.identityId("idt_0501db5c-baf9-4be1-a931-f4bae7f3a41d")
.currency("USD"));
```
```bash Blnk CLI wrap theme={"system"}
blnk balances create
```
```json Response {10} wrap theme={"system"}
{
"balance": 0,
"version": 0,
"inflight_balance": 0,
"credit_balance": 0,
"inflight_credit_balance": 0,
"debit_balance": 0,
"inflight_debit_balance": 0,
"ledger_id": "ldg_073f7ffe-9dfd-42ce-aa50-d1dca1788adc",
"identity_id": "idt_0501db5c-baf9-4be1-a931-f4bae7f3a41d",
"balance_id": "bln_e39a239a-a6ca-4509-b0d9-29dcc5630f8a",
"indicator": "",
"currency": "USD",
"created_at": "2024-07-05T08:13:18.882616461Z",
"meta_data": {
"customer_internal_id": "1234",
"customer_name": "Jerry"
}
}
```
***
## Update a balance's identity
You can update the identity associated with an existing balance using the [**Update Balance Identity**](/reference/update-balance-identity) endpoint:
```bash cURL wrap theme={"system"}
curl -X PUT "http://localhost:5001/balances/{id}/identity" \
-H "X-blnk-key: " \
-H "Content-Type: application/json" \
-d '{
"identity_id": "idt_3b63c8da-af29-4cc3-ad38-df17d87456e6"
}'
```
```typescript TypeScript wrap theme={"system"}
const response = await blnk.LedgerBalances.updateIdentity(
'bln_e39a239a-a6ca-4509-b0d9-29dcc5630f8a',
{
identity_id: 'idt_3b63c8da-af29-4cc3-ad38-df17d87456e6',
},
);
```
```go Go wrap theme={"system"}
result, resp, err := client.LedgerBalance.UpdateIdentity(
"bln_e39a239a-a6ca-4509-b0d9-29dcc5630f8a",
blnkgo.UpdateBalanceIdentityRequest{
IdentityID: "idt_3b63c8da-af29-4cc3-ad38-df17d87456e6",
},
)
```
```python Python wrap theme={"system"}
response = blnk.ledger_balances.update_identity(
"bln_e39a239a-a6ca-4509-b0d9-29dcc5630f8a",
{
"identity_id": "idt_3b63c8da-af29-4cc3-ad38-df17d87456e6",
},
)
```
```java Java wrap theme={"system"}
ApiResponse response = blnk.ledgerBalances().updateIdentity(
"bln_e39a239a-a6ca-4509-b0d9-29dcc5630f8a",
UpdateBalanceIdentity.create()
.identityId("idt_3b63c8da-af29-4cc3-ad38-df17d87456e6"));
```
```bash Blnk CLI wrap theme={"system"}
blnk balances update-identity
```
```json Response wrap theme={"system"}
{
"balance_id": "bln_e39a239a-a6ca-4509-b0d9-29dcc5630f8a",
"identity_id": "idt_3b63c8da-af29-4cc3-ad38-df17d87456e6",
"ledger_id": "ldg_073f7ffe-9dfd-42ce-aa50-d1dca1788adc",
"currency": "USD"
}
```
You can link a balance to a different identity. The identity must exist in your system before you can associate it with a balance. This provides flexibility in managing customer data relationships.
***
## Need help?
We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool.
To ask questions or discuss issues, please [contact us](mailto:support@blnkfinance.com) or [join our Discord community](https://discord.gg/7WNv94zPpx).
Sign up and manage your ledger with our back-office dashboard. You can invite teammates to collaborate and manage your ledger operations directly from the dashboard.