Home / Servers / Brevo API / begin_transaction
Create new transaction
An MCP tool from the Brevo API server, hosted on mcp.hjlabs.in.
Create new transaction Creates new transaction and returns information [POST /loyalty/balance/programs/{pid}/transactions]
Name on the gateway: brevo_api__begin_transaction · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
pid required | string | Loyalty Program Id |
amount required | number | Transaction amount. A positive value creates a credit transaction and a… |
transactionType | credit | debit | Explicit transaction type. If not provided, the type is inferred from the sign… |
balanceDefinitionId required | string | Unique identifier (UUID) of the associated balance definition. |
contactId | integer | Unique identifier of the contact involved in the transaction. Required unless… |
LoyaltySubscriptionId | string | Unique identifier for the loyalty subscription. Required unless contactId is… |
meta | object | Optional metadata associated with the transaction. |
ttl | integer | Time-to-live for the transaction in seconds. Must be at least 10 seconds if… |
eventTime | string | Timestamp specifying when the transaction event occurred (ISO 8601 / RFC 3339… |
autoComplete | boolean | Whether the transaction should be automatically completed. |
balanceExpiryInMinutes | integer | Expiry time for the balance in minutes. Must be greater than 0 if provided.… |
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__begin_transaction",
"arguments": {
"pid": "…",
"amount": 0,
"balanceDefinitionId": "…"
}
}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 new transaction tool with pid set to ….