Sign in
Refill Configurations

Create a refill configuration.

post/v2/refill-configurations

Headers

Idempotency-Keystring

Non-empty idempotency key for deduplicating write requests on the same route.

Example:6f31c20e-725c-4be8-96f4-835042f67602

Optional. Duplicate keys within the same company namespace and route return 409.

Request body

account_idstring required

LedgerUp account identifier.

metric_idstring required

LedgerUp metric identifier.

minimum_balancestring required

Decimal balance serialized as a string.

target_balancestring required

Decimal balance serialized as a string.

is_activeboolean required

Whether automatic refills are enabled.

Example request

{
  "account_id": "account_0194f4e3a2b77c6aa91c4f6b4db2a980",
  "metric_id": "metric_0194f4e3a2b77c6aa91c4f6b4db2a980",
  "minimum_balance": "100.0",
  "target_balance": "100.0",
  "is_active": true
}

Response

Created.

account_idstring required

LedgerUp account identifier.

metric_idstring required

LedgerUp metric identifier.

minimum_balancestring required

Decimal balance serialized as a string.

target_balancestring required

Decimal balance serialized as a string.

is_activeboolean required

Whether automatic refills are enabled.

created_atinteger required

Unix timestamp in seconds.

updated_atinteger required

Unix timestamp in seconds.

Example response

{
  "account_id": "account_0194f4e3a2b77c6aa91c4f6b4db2a980",
  "metric_id": "metric_0194f4e3a2b77c6aa91c4f6b4db2a980",
  "minimum_balance": "100.0",
  "target_balance": "100.0",
  "is_active": true,
  "created_at": 1767225600,
  "updated_at": 1767225600
}

Changes