Home / Servers / Brevo API / create_balance_order
Create balance order
An MCP tool from the Brevo API server, hosted on mcp.hjlabs.in.
Create balance order Returns created order [POST /loyalty/balance/programs/{pid}/create-order]
Name on the gateway: brevo_api__create_balance_order · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
pid required | string | Loyalty Program Id |
amount required | number | Order amount (must be non-zero). |
balanceDefinitionId required | string | Unique identifier (UUID) of the associated balance definition. |
contactId required | integer | Unique identifier of the contact placing the order (must be ≥ 1). |
dueAt required | string | RFC3339 timestamp specifying when the order is due. |
expiresAt | string | Optional RFC3339 timestamp defining order expiration. |
meta | object | Optional metadata associated with the order. |
source required | engine | user | Specifies the origin of the order. |
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__create_balance_order",
"arguments": {
"pid": "…",
"amount": 0,
"balanceDefinitionId": "…",
"contactId": 0,
"dueAt": "…",
"source": "…"
}
}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 order tool with pid set to ….