Skip to main content
Updates the user’s email notification preferences. Pass only the fields you want to change; authorization (approval) settings cannot be changed here, they are managed in the dashboard.

Parameters

ParameterTypeRequiredDescription
card_details_accessedbooleanNoEmail when a card’s full details (PAN/CVV) are accessed.
card_createdbooleanNoEmail when a new card is created.
transactionbooleanNoEmail on each card transaction.
card_closedbooleanNoEmail when a card is closed.
low_balancebooleanNoEmail when a card balance drops below the low-balance threshold.
low_balance_threshold_centsnumberNoLow-balance alert threshold in cents (e.g. 500 = $5.00).

Returns

A confirmation with status: "ok" and a summary of the settings after the change, including the full set of notification preferences. If you pass no fields at all, it makes no request and returns status: "noop", asking for at least one preference to update.

Example

{ "name": "update_settings", "arguments": { "transaction": false, "low_balance_threshold_cents": 500 } }