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”:

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.
Updated 4 days ago