Advanced Features

Webhooks

Get real-time alerts for key events — low balance, usage limits, and account changes. You can receive them by email, webhook, Bark, or Gotify, all set up from your own account.

When You’ll Be Notified

You’ll get a notification whenever something important happens on your account — most commonly around your balance and usage:

  • Low balance — So you can top up before you run out
  • Usage and quota alerts — When you approach your configured limits
  • Account events — Status changes on your account or API keys

Setting Up Notifications

  1. Log in to your account at api.tokspan.com/profile
  2. Open Settings & Preferences
  3. Under Notifications, choose your delivery channel: Email, Webhook, Bark, or Gotify
  4. For webhook delivery, enter your HTTPS endpoint URL and choose which events to subscribe to
  5. Save — alerts are delivered in real time whenever an event fires
Secure your notification endpoint. If you use a public webhook URL, only process notifications that come from TokSpan and respond with a 2xx status to confirm delivery. If your notification settings expose a shared secret or signature option, enable it to further harden your endpoint.