Tokens tells you about money and limits by email, so a long agent session does not end with a surprise. This page lists every email the platform sends to your account, which of them you can switch off, what triggers each one, and how to check that an email was sent. For the usage numbers behind the alerts, see usage, limits and alerts.
Where to find the settings#
Open Notifications in the dashboard sidebar, under Account. The page is titled Email Alerts & Notifications and has three parts:
- Billing & Lifecycle Alerts: receipts, renewal reminders, payment failures and the low wallet balance alert.
- Token Quota Milestones: warnings as you use up your plan's credits.
- Delivery History & Audit Trail: a log of the emails sent to you.
Each switch is a checkbox that saves as soon as you click it. The page shows "Notification preferences successfully updated and saved." when it worked. If the settings cannot be loaded, the switches stay disabled and the badge next to the title reads Unavailable; press Refresh to try again.
The Notifications tab in Settings shows the same topics as a read-only summary, with a link to this page. Its "Enabled" badges are fixed text and do not follow your switches, so use the Notifications page as the source of truth.
Note
All alerts are emails. They go to the email address on your account. Tokens has no SMS, push or in-dashboard notification for these alerts.
Alerts you can switch on or off#
Everything below is on by default for every account. Your choice is stored per account; it is not per API key.
| Switch on the page | What triggers it | Sent |
|---|---|---|
| Checkout & Wallet Receipts | A subscription checkout or a wallet top-up is confirmed by the payment provider | Right after the payment is confirmed |
| Subscription Renewal Reminders | Your paid plan's period ends within 3 days | Once per plan period |
| Payment Failure Notices | A payment is reported as failed or cancelled by the payment provider | Right after the failure is reported |
| Low Wallet Balance Alerts | Your USD wallet balance is below $5.00 | At most once per day while the balance stays below the threshold |
| Token Quota Milestones | The share of your plan's credits you have used reaches 50%, 75%, 90% or 100% | Once per threshold per plan period |
Checkout & Wallet Receipts#
The label says "Receive verified receipts for subscription checkouts and prepaid credit deposits." The email is sent when the payment provider confirms the payment, for plan purchases and for wallet top-ups. It carries the invoice number, amount, currency and payment method. A printable receipt is also in billing.
Manual payments (a bank or mobile-wallet transfer you submit with a transaction id) have their own emails, listed in the next section.
Subscription Renewal Reminders#
Sent about 3 days before your plan period ends, with the plan name, the date and the price. A few rules from the code:
- Only paid plans get a reminder. Free plans and plans with a price of zero do not.
- If the next period is already paid for, no reminder is sent.
- You get one reminder per period.
Plans do not renew by themselves, so this email is your cue to pay for the next period. See plans, credits and wallet.
Payment Failure Notices#
Sent when a payment you started is reported as failed or cancelled. The email says the payment did not go through and gives the amount. Start the payment again from billing.
Low Wallet Balance Alerts#
The page says "Receive an email when your prepaid wallet drops below $5.00 USD to prevent API request dropouts." Details:
- The check covers your USD wallet. A BDT wallet balance does not trigger this email.
- The threshold is $5.00. The page has no field to change it.
- While the balance stays below the threshold you get at most one email per day. Top up and the alerts stop.
The Wallet page shows its own "Low Balance" badge, which uses a different limit ($1 for the USD wallet). The badge and the email are independent.
Token Quota Milestones#
These emails warn you before your plan's credits run out. The percentage is the share of your active plan's credit pool for the current period that has been used. The four rows are:
| Row | Label on the page |
|---|---|
| 50% | Halfway threshold reached |
| 75% | Three quarters threshold warning |
| 90% | Critical quota warning |
| 100% | Quota exhausted notification |
How it behaves:
- Enable All (top right of the card) is a master switch for the whole group. Turn it off and the four row switches become disabled, and none of the milestone emails are sent. Turning it back on restores whatever the four rows were set to.
- Each row can be switched on its own.
- Each milestone is sent once per plan period. If your usage jumps past several milestones between two checks, you get one email for each.
- If you switch a milestone on after you have already passed it, the email is sent on the next check.
- These emails are for accounts with an active plan. They look at the plan's credit pool, so they do not apply to a wallet-only account.
The alerts are produced by a scheduled check that runs about every five minutes, so an email can arrive a few minutes after you cross a threshold, not at the exact request. A failed send is retried up to 3 times in the same period.
Emails with no switch on the Notifications page#
Usage window and model allowance warnings#
If your plan has usage windows (for example a 5-hour session or a weekly ceiling) you also get a warning at 80% and a notice at 100% of a window. When a plan sets a spending limit on one model, you get the same two emails for that model ("... 80% of its allowance used", "... allowance used up").
These are on by default. The Notifications page does not show a switch for them, so you cannot turn them off from the dashboard. Each window or model sends each of the two emails once per window or period. To see the windows themselves, use the Usage page or GET /v1/tokens/usage as described in usage, limits and alerts.
Payment and account emails#
These are always sent when the event happens:
| When | |
|---|---|
| We received your payment details | You submit a manual payment (a transaction id) for a plan or top-up |
| Payment approved | Staff confirm your manual payment |
| Payment rejected | Staff cannot verify your manual payment; the email gives the reason |
| Confirm your email address | You create an account |
| Reset your password, sign-in link | You ask for a password reset or a sign-in link |
| Confirm your email change | An email change is requested for your account |
| Support ticket reply, ticket closed | Staff answer or close a ticket you opened |
Support emails link back to your tickets; the full conversation stays in the dashboard.
Delivery history#
The Delivery History & Audit Trail table lists the emails recorded for your account, newest first. The badge shows how many records were loaded. The page loads the latest 20. Columns:
| Column | Meaning |
|---|---|
| Event Type | The internal name of the email, for example checkout_receipt |
| Subject | The subject line |
| Recipient | The address it was sent to |
| Status | sent, failed, suppressed, or sent (test mode) |
| Timestamp | When it was recorded, in your browser's time zone |
What the statuses mean:
- sent: handed to the email provider.
- failed: the provider or the mail server refused it. The platform retries milestone, renewal and window alerts up to 3 times per period.
- suppressed: it was due, but you had that alert switched off (or your address could not be resolved), so nothing was sent. Receipts, payment failures and similar alerts leave such a row. Quota milestones, renewal reminders and low balance alerts are checked before sending, so a switched-off alert simply leaves no row.
- sent (test mode): the platform's email provider is set to test mode, so the message was recorded but not delivered.
An empty table shows "No notification events recorded yet. Complete a checkout to create one." Account emails such as the confirmation link and support ticket emails are not tied to your user record in the log, so they do not appear in this table.
If an email does not arrive#
- Check the history table. If the row says
suppressed, switch the alert back on. - If there is no row, the event may not have happened yet. Milestones and reminders are produced by the scheduled check, so allow a few minutes.
- Look in your spam folder, and make sure the address in Settings is the one you read.
- If the row says
failed, or you expected an email and have no record, send the event type and time to support.