curl --request PUT \
  --url https://intentleads.si/api/v1/billing/auto-topup \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "enabled": true,
  "amount": 500,
  "threshold": 50
}
'

{
  "enabled": true,
  "amount_usd": 500,
  "threshold_usd": 50,
  "triggers": {
    "low_balance": true,
    "billing_day": true
  },
  "billing_day_by": "auto",
  "amount_choices_usd": null,
  "paused": null,
  "paused_at": null,
  "card": {
    "brand": "visa",
    "last4": "4242"
  },
  "last": {
    "trigger": "low_balance",
    "amount_usd": 500,
    "status": "paid",
    "at": "2026-11-20T09:14:02.000Z",
    "paid_at": "2026-11-20T09:14:04.000Z",
    "invoice_url": "https://invoice.example.com/i/acct_1/in_1",
    "error": null
  }
}

Set the automatic top-up

Adds amount US dollars ($250 or more) by card when the available balance drops below threshold, and on the billing day once a month. Each automatic top-up has its own invoice. {"enabled": false} turns it off.

No card on file: 409 card_required with a card_setup_url. Add the card there; the automatic top-up switches on with these settings once it’s saved.
A failed payment pauses automatic top-ups (paused: payment_failed) until a new card is added or the invoice is paid. The low-balance top-up runs at most 5 times a billing month (paused: monthly_cap); saving the settings again resumes it.
An older monthly card payment ( $250,$ 500, $1,000 or$ 2,000) is the billing-day part: amount must be one of those, and "low_balance": false keeps only the monthly payment.

Admin key required. Standard keys get 403 admin_key_required.

PUT

/

api

/

v1

/

billing

/

auto-topup

curl --request PUT \
  --url https://intentleads.si/api/v1/billing/auto-topup \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "enabled": true,
  "amount": 500,
  "threshold": 50
}
'

{
  "enabled": true,
  "amount_usd": 500,
  "threshold_usd": 50,
  "triggers": {
    "low_balance": true,
    "billing_day": true
  },
  "billing_day_by": "auto",
  "amount_choices_usd": null,
  "paused": null,
  "paused_at": null,
  "card": {
    "brand": "visa",
    "last4": "4242"
  },
  "last": {
    "trigger": "low_balance",
    "amount_usd": 500,
    "status": "paid",
    "at": "2026-11-20T09:14:02.000Z",
    "paid_at": "2026-11-20T09:14:04.000Z",
    "invoice_url": "https://invoice.example.com/i/acct_1/in_1",
    "error": null
  }
}

Authorizations

Authorization

string

header

required

An Intent Leads API key, e.g. il_live_ followed by 32 letters and digits. Create one on the API and CLI page of the dashboard.

Body

application/json

enabled

boolean

required

amount

number

US dollars, $250 or more.

threshold

number

US dollars; the low-balance top-up runs below this.

low_balance

boolean

Only with an older monthly card payment: false keeps just the monthly payment.

email

string<email>

Prefills the card page.

Response

The automatic top-up after the change.

enabled

boolean

required

On when anything tops up automatically (the low-balance top-up, the billing-day top-up, or an older monthly card payment).

amount_usd

number | null

required

Added each time, $250 or more.

threshold_usd

number | null

required

The low-balance top-up runs when the available balance drops below this. Null when that part is off.

triggers

object

required

Show child attributes

billing_day_by

enum<string> | null

required

Who does the billing-day top-up: auto (us) or subscription (an older monthly card payment).

Available options:

auto,

subscription

amount_choices_usd

number[] | null

required

With a monthly card payment, the amount is one of these.

paused

enum<string> | null

required

Why automatic top-ups are paused: a failed payment, 5 low-balance top-ups this billing month, or no card.

Available options:

payment_failed,

monthly_cap,

no_card

paused_at

string<date-time> | null

required

card

object | null

required

Show child attributes

last

object | null

required

Show child attributes