Skip to main content
PUT
/
api
/
v1
/
auto-topup
/
settings
# Enable threshold-based topup at $50, recharge $100
curl -X PUT "https://app.talkover.ai/api/v1/auto-topup/settings" \
  -H "Authorization: Bearer talq_your_environment_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "is_enabled": true,
    "threshold_amount": 50,
    "recharge_amount": 100,
    "payment_method_id": "pm_uuid_1"
  }'

{
  "success": true,
  "data": {
    "is_enabled": true,
    "threshold_amount": 50.00,
    "recharge_amount": 100.00,
    "scheduled_payment_enabled": false,
    "payment_method_id": "pm_uuid_1",
    "daily_limit": 500.00,
    "updated_at": "2024-01-15T13:00:00Z"
  }
}

​
Update Auto Topup Settings

Configure or update auto topup. You can enable threshold-based recharging (auto-charge when balance drops below threshold_amount), monthly scheduled recharging (auto-charge on a specific day), or both.

​
Endpoint

PUT /api/v1/auto-topup/settings

​
Request headers

​
Authorization
string
required
Bearer token. Format: Bearer talq_your_environment_token_here
​
Content-Type
string
required
Must be set to application/json

​
Request body

​
is_enabled
boolean
Master switch for auto topup. When false, neither threshold nor scheduled recharges fire.
​
threshold_amount
number
Trigger threshold in account currency. Range: 1–1000. When the balance drops below this, a recharge is queued.
​
recharge_amount
number
Amount charged each time the threshold is hit. Range: 1–1000.
​
scheduled_payment_enabled
boolean
Enables monthly scheduled recharges in addition to (or instead of) threshold-based.
​
scheduled_amount
number
Amount charged on the scheduled day. Range: 1–1000. Required when scheduled_payment_enabled is true.
​
day_of_month
integer
Day of month for scheduled recharges. Range: 1–28 (avoids month-end edge cases).
​
payment_method_id
string
ID of the payment method to charge. Must be a method already saved on the account — see List Payment Methods.

​
Examples

# Enable threshold-based topup at $50, recharge $100
curl -X PUT "https://app.talkover.ai/api/v1/auto-topup/settings" \
  -H "Authorization: Bearer talq_your_environment_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "is_enabled": true,
    "threshold_amount": 50,
    "recharge_amount": 100,
    "payment_method_id": "pm_uuid_1"
  }'

​
Response

{
  "success": true,
  "data": {
    "is_enabled": true,
    "threshold_amount": 50.00,
    "recharge_amount": 100.00,
    "scheduled_payment_enabled": false,
    "payment_method_id": "pm_uuid_1",
    "daily_limit": 500.00,
    "updated_at": "2024-01-15T13:00:00Z"
  }
}

​
Notes

  • The daily_limit is set by your plan and cannot be modified via API. Contact support to request an increase.
  • To turn off auto topup entirely, send {"is_enabled": false} or use Disable Auto Topup.
  • After updating, run Test Auto Topup to verify the payment method works.