> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blnkfinance.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Create new balance
> How to create a new ledger balance in Blnk.
export const CtaCallout = props => {
const {title, buttonLabel, href, trackingEvent, buttonTarget, rel = "noopener noreferrer", children} = props;
const handleCtaClick = () => {
if (typeof window === "undefined" || !trackingEvent) {
return;
}
try {
window.dispatchEvent(new CustomEvent("blnk:docs-cta", {
detail: {
name: trackingEvent,
href
}
}));
} catch {}
try {
window.posthog?.capture?.(trackingEvent, {
href
});
} catch {}
const gaPayload = {
cta_href: href
};
try {
window.gtag?.("event", trackingEvent, gaPayload);
} catch {}
try {
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
event: trackingEvent,
...gaPayload
});
} catch {}
};
const isExternal = typeof href === "string" && (/^https?:\/\//i).test(href);
const target = buttonTarget ?? (isExternal ? "_blank" : undefined);
const linkRel = isExternal ? rel : undefined;
return ;
};
If you're using the auto-provisioned `Enterprise Core` instance included with your Production License deployment, set the base URL to: `https://ENTERPRISE_PUBLIC_URL/core`.
If you're connecting to a different Core instance, use the publicly accessible base URL for that instance instead.
### Authorization
If set, the API uses an API key for authentication. Include the following header in your requests: `X-blnk-key: `.
Replace `` with your secret API key. Ensure the key is kept secure and not exposed in public repositories or client-side code.
See also: [Scoped API keys](/api-keys/overview) and [Secure your Blnk server](/advanced/secure-blnk).
### Body
Unique id of the ledger the balance is created in.
The currency/asset class of this balance. See the following: [Currencies](/guides/currencies)
Unique id of identity (if any) to be linked to the balance. Can be left out from the request body if there's no identity to be linked.
Enables fund lineage tracking on this balance.
Fund lineage requires `identity_id`.
Controls how Blnk allocates tagged provider funds when spending from this balance.
Supported values: `FIFO`, `LIFO`, `PROPORTIONAL`.
Additional metadata for the request body.
### Response
The net amount being stored in the balance.
The net amount waiting to be moved into or out of the balance.
Total amount moved into the balance
Total amount waiting to be moved into the balance.
Total amount moved out of the balance.
Total amount waiting to be moved out of the balance.
Unique id of the ledger the balance is created in.
Unique id of the identity (if any) linked to this balance.
Unique id of the created balance.
The currency/asset class of the balance.
Indicates the date & time of creation.
Additional metadata of the balance.
Indicates whether fund lineage tracking is enabled for this balance.
The allocation strategy used for fund lineage spending when `track_fund_lineage` is enabled.
```bash theme={"system"}
curl -X POST "http://localhost:5001/balances" \
-H "X-blnk-key: " \
-H "Content-Type: application/json" \
-d '{
"ledger_id": "ldg_049495c6-356e-4ebc-a45e-60d1e1e16afb",
"currency": "USD",
"identity_id": "idt_4dd12897-f085-41f2-955f-790ed3c0a7fb",
"track_fund_lineage": true,
"allocation_strategy": "FIFO"
}'
```
```json 201 theme={"system"}
{
"balance": 0,
"inflight_balance": 0,
"credit_balance": 0,
"inflight_credit_balance": 0,
"debit_balance": 0,
"inflight_debit_balance": 0,
"ledger_id": "ldg_049495c6-356e-4ebc-a45e-60d1e1e16afb",
"identity_id": "",
"balance_id": "bln_5ce86029-3c2e-4e2a-aae2-7fb931ca4c4f",
"currency": "USD",
"created_at": "2024-11-26T08:36:36.238244338Z",
"meta_data": null
}
```
```json 400 theme={"system"}
{
"errors": "ledger_id: cannot be blank.",
"error_detail": {
"code": "GEN_VALIDATION_ERROR",
"message": "ledger_id: cannot be blank."
}
}
```
## 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.