Overview
ACN sends email notifications for billing events to help you stay informed and avoid unexpected service interruptions. All notifications go to the email address associated with your developer account.
You can configure which notifications you receive in Settings → Notifications in the dashboard, or via the Billing API.
Notification Types
Payment Confirmed
Sent immediately after a successful Stripe top-up. Includes:
- Amount paid (USD)
- Credits added
- Link to Stripe receipt
- New balance
Enabled by default. Cannot be disabled.
Low Balance Alert
Sent when your credit balance drops below a threshold you configure.
Default threshold: None (you set it)
Cooldown: Sent at most once per 24 hours
Set your threshold in Billing → Notifications, or via API:
curl -X PUT https://api.acn.exchange/v1/billing/alerts \
-H "Authorization: Bearer acn_sk_your_key" \
-d '{
"lowBalanceThresholdUsdc": "5.00",
"emailNotifications": { "lowBalance": true }
}'
Credits Depleted
Sent when your balance reaches zero and calls start failing. This is a last-resort alert — set up a Low Balance Alert beforehand to avoid hitting zero.
Enabled by default. Cannot be disabled.
Daily Limit Reached
Sent when your daily spending limit is hit and calls are being blocked.
Requires a daily spend limit to be configured.
"emailNotifications": { "dailyLimitReached": true }
Auto-Refund Notification
Sent when credits are automatically refunded due to a provider failure (5xx error or timeout). Includes:
- Credits refunded
- Capability that failed
- Reason
Opt-in. Useful for debugging provider reliability.
"emailNotifications": { "creditsRefunded": true }
Unusual Activity Alert
Sent when API key usage spikes more than 3× your 7-day rolling average in a short window. Indicates a potential runaway agent loop or compromised API key.
Includes:
- Usage spike details
- Link to review your active API keys
- Link to set or lower spending limits
"emailNotifications": { "unusualActivity": true }
If you receive an unusual activity alert and don’t recognize the usage pattern, revoke the affected API key immediately from Settings → API Keys.
Account Suspended
Sent if your account is suspended by an ACN admin. All API calls will return HTTP 403 until the suspension is resolved.
Enabled by default. Cannot be disabled.
Daily & Weekly Usage Summary (Opt-In)
Digest emails summarizing your usage over the past day or week. Includes:
- Total credits spent
- Top providers by spend
- Call counts and refund rates
"emailNotifications": {
"dailySummary": true,
"weeklySummary": true
}
curl -X PUT https://api.acn.exchange/v1/billing/alerts \
-H "Authorization: Bearer acn_sk_your_key" \
-H "Content-Type: application/json" \
-d '{
"lowBalanceThresholdUsdc": "5.00",
"emailNotifications": {
"lowBalance": true,
"dailyLimitReached": true,
"creditsRefunded": false,
"unusualActivity": true,
"dailySummary": false,
"weeklySummary": true
}
}'
Alert Reference
| Alert | Default | Configurable | Cooldown |
|---|
| Payment confirmed | On | No | None |
| Low balance | Off | Yes (threshold) | 24h |
| Credits depleted | On | No | None |
| Daily limit reached | On (if limit set) | Yes | None |
| Auto-refund | Off | Yes | None |
| Unusual activity | Off | Yes | 4h |
| Account suspended | On | No | None |
| Daily summary | Off | Yes | Daily |
| Weekly summary | Off | Yes | Weekly |
