Home / Servers / Brevo API / post_loyalty_balance_programs_by_pid_balance_definitions
Create balance definition
An MCP tool from the Brevo API server, hosted on mcp.hjlabs.in.
Create balance definition Creates balance definition and returns information [POST /loyalty/balance/programs/{pid}/balance-definitions]
Name on the gateway: brevo_api__post_loyalty_balance_programs_by_pid_balance_definitions · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
pid required | string | Loyalty Program Id |
balanceAvailabilityDurationModifier | noModification | startOfPeriod | endOfPeriod | Defines when the balance expires within the selected duration. |
balanceAvailabilityDurationUnit | day | week | month | year | Unit of time for balance validity. |
balanceAvailabilityDurationValue | integer | Number of time units before the balance expires. |
balanceExpirationDate | string | Fixed expiration date (dd/mm format) as an alternative to duration-based expiry. |
balanceOptionAmountOvertakingStrategy | strict | partial | Defines whether partial credit is allowed when reaching max balance. |
balanceOptionCreditRounding | lower | upper | natural | Defines rounding strategy for credit transactions. |
balanceOptionDebitRounding | lower | upper | natural | Defines rounding strategy for debit transactions. |
description | string | Short description of the balance definition. |
imageRef | string | URL of an optional image reference. |
maxAmount | number | Maximum allowable balance amount. |
maxCreditAmountLimit | number | Maximum credit allowed per operation. |
maxDebitAmountLimit | number | Maximum debit allowed per operation. |
meta | object | Additional metadata for the balance definition. |
minAmount | number | Minimum allowable balance amount. |
name required | string | Name of the balance definition. |
unit required | POINTS | EUR | USD | MXN | GBP | INR | CAD | SGD | RON | JPY | MYR | CLP | PEN | MAD | AUD | CHF | BRL | Unit of balance measurement. |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "brevo_api__post_loyalty_balance_programs_by_pid_balance_definitions",
"arguments": {
"pid": "…",
"name": "…",
"unit": "…"
}
}Or connect the Brevo API server directly, which lists 291 tools including this one:
claude mcp add --transport http hj-brevo-api https://mcp.hjlabs.in/mcp/brevo-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the create balance definition tool with pid set to ….