> ## 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.
# Register new hooks
> How to register new hooks 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 ;
};
Available in version 0.8.4 or later.
Send the master key (`server.secret_key`) in the `X-Blnk-Key` header. Regular API keys return `403 Forbidden`.
### Body
Name of the hook. Ensure it is as descriptive as possible for easy reference.
Endpoint URL where the hook will send requests.
Type of the hook - `PRE_TRANSACTION` or `POST_TRANSACTION`.
Indicates whether the hook is enabled or disabled.
Maximum time (in seconds) allowed for the hook to execute.
Maximum number of retry attempts if the hook fails.
```json theme={"system"}
curl -X POST "http://localhost:5001/hooks" \
-H "X-blnk-key: " \
-H "Content-Type: application/json" \
-d '{
"name": "Pre-transaction validation",
"url": "https://api.example.com/validate",
"type": "PRE_TRANSACTION",
"active": true,
"timeout": 30,
"retry_count": 3
}'
```
```json 403 theme={"system"}
{
"error": "hook management requires master key",
"error_detail": {
"code": "AUTH_MASTER_KEY_REQUIRED",
"message": "hook management requires master key"
}
}
```
## 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.