Managing your balance

Managing your balance in the Tremendous dashboard

To add funds to your Tremendous account manually, simply log into the Tremendous UI and click “Add funds”:

Screenshot 2025-08-14 at 10.41.03 AM.png

From there, you will see many options for adding funds, including:

  • Bank account
  • Credit card
  • ACH / Wire transfer from bank
  • Invoice

This article has more information about these options.

In the dashboard, you can also configure low balance alerts to be notified when your Tremendous balance dips below a certain threshold, and auto-reload to automatically replenish your balance.

Managing your balance with API Topups

If you have a bank account or credit card stored on your account, you can make an API request to add funds to your Tremendous balance using this funding source. This is called a "topup".

First, verify that the funding source you'd like to use has balance_funding in the list of usage_permissions, and that the funding source is active.

Next, make a POST request to the /api/v2/topups endpoint to create a topup and add funds to your balance. Each topup you create requires a unique idempotency key to ensure that the topup is only performed once - see more on this below.

curl --request POST \
     --url https://testflight.tremendous.com/api/v2/topups \
     --header 'accept: application/json' \
     --header 'authorization: Bearer YOUR_API_KEY_HERE' \
     --header 'content-type: application/json' \
     --data '
{
  "funding_source_id": "YOUR-SELECTED-SOURCE-ID",
  "idempotency_key": "idempotency-key",
  "amount": 200.35
}
'

When the topup is successfully created, you will receive a response indicating that the status is created :

{
  "topup": {
    "id": "XC82V7YJI4CC",
    "amount": 200.35,
    "processing_fee": 6.01,
    "funding_source_id": "FUNDING-SOURCE-ID",
    "status": "created",
    "created_at": "2025-08-14T22:22:30.783Z",
    "fully_credited_at": null,
    "rejected_at": null,
    "reversed_at": null,
    "reversed_reason": null,
    "idempotency_key": "abc1234"
  }
}

Once the funds are applied to your balance, the topup will show a status of fully_credited. You can listen for the webhook event TOPUPS.FULLY_CREDITED to be notified when this happens. In some cases this can take up to one business day, but usually happens much faster.

Idempotency
You must include an idempotency key when calling POST /topups. The same key can be retried any number of times, but we guarantee at most one successful topup per key.

  • If no prior request with that key has been accepted, the request is processed normally.
  • If a prior request with that key was accepted (a topup resource was created—status created or fully_credited), any subsequent request with the same key will be rejected with HTTP 409 Conflict and reference the existing topup.
  • If a prior request with that key failed (e.g., validation error/4xx), you may reuse the same key to resubmit corrected parameters; it will be treated as a fresh attempt.

Do not reuse an idempotency key for different intended topups.