Home / Servers / Brevo API / update_balance_definition

Update balance definition

An MCP tool from the Brevo API server, hosted on mcp.hjlabs.in.

Update balance definition Updates Balance definition [PUT /loyalty/balance/programs/{pid}/balance-definitions/{bdid}]

Name on the gateway: brevo_api__update_balance_definition · may change things.

Parameters

Name	Type	Description
`pid` required	`string`	Loyalty Program Id
`bdid` required	`string`	Balance Definition 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`	Expiration date (dd/mm format) or empty if not applicable.
`balanceOptionAmountOvertakingStrategy`	`strict \| partial`	Defines whether partial credit is allowed when reaching max balance.
`balanceOptionCreditRounding`	`lower \| upper \| natural`	Rounding strategy for credit transactions.
`balanceOptionDebitRounding`	`lower \| upper \| natural`	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`	Optional 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.

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments

{
  "name": "brevo_api__update_balance_definition",
  "arguments": {
    "pid": "…",
    "bdid": "…",
    "name": "…",
    "unit": "…"
  }
}

Or connect the Brevo API server directly, which lists 291 tools including this one:

Run in your terminal

claude mcp add --transport http hj-brevo-api https://mcp.hjlabs.in/mcp/brevo-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Use the update balance definition tool with pid set to ….