Top up Gateway credits
When your Gateway credits balance runs low, top it up from the Cloud admin dashboard. You can add credit manually whenever you need it, or turn on auto top-up so n8n refills your balance for you.
Only the instance owner can top up, and topping up requires an active paid subscription. Free trials include Gateway credits, but not top-ups: if you use up your free credit during a trial, upgrade to a paid plan to add more.
Top up manually
Open the Cloud admin dashboard and select the Gateway credits tab.
Select Top up.
Choose an amount and complete the checkout. You can pay with the payment method saved on your subscription or with a different one. n8n emails you an invoice.
Your new balance appears on the page once the payment completes.
Set up auto top-up
Auto top-up refills your balance whenever it drops below a threshold you set, keeping it above zero so workflows that rely on Gateway credits keep running. Unlike manual top-ups, auto top-up always charges the payment method saved on your subscription.
Open the Cloud admin dashboard and select the Gateway credits tab.
Turn on Auto top-up.
Set When balance drops to (the balance that triggers a top-up) and Top up to (the balance to refill to).
Optionally, turn on Monthly auto top-up limit to cap how much auto top-up can add per month.
Select Save changes.
How auto top-up behaves:
n8n emails you an invoice each time auto top-up adds credit.
If you set a monthly limit, auto top-up pauses once it adds that amount in the current month, and resumes the next month.
If a payment fails, n8n retries. If the retries also fail, n8n turns auto top-up off and emails you. Because auto top-up always charges the payment method saved on your subscription, fix that payment method before turning it back on.
Overspend
Your balance can run out in the middle of an execution. When that happens, n8n lets the in-flight Gateway requests finish rather than stopping them partway through, so your balance can dip slightly below zero. n8n deducts the overspent amount from your next top-up, and the deduction appears in your top-up history.
Refunds
Top-ups are final. n8n doesn't refund unused credits except where required by law. If you think a charge is wrong, contact n8n support. For expiry and forfeiture rules, refer to Credit expiry and forfeiture.
Related resources
Gateway credits: how Gateway credits work.
Track Gateway credit spend: monitor your balance, spend, and top-up history.
Service pricing page: current rates for all supported services and models.
Last updated
Was this helpful?