n8n & webhook integrations

What you can subscribe to

Outbound webhooks are available on paid plans. Add an endpoint under Integrations > Webhooks in the dashboard, choosing the n8n or Zapier preset or a generic URL.

There is one event today:

• •budget.threshold_crossed - fires when your organization's month-to-date spend crosses 50%, 80%, 100% or 150% of the monthly budget set in Settings > Budget. If several levels are crossed at once, you get one delivery for the highest level, listing every level crossed.

spend_threshold.breached is still accepted as a deprecated alias for existing subscriptions; use budget.threshold_crossed for new ones. There is no weekly-digest or savings-opportunity webhook.

Payload

The body is a flat JSON object. The event type travels in the X-Tokeven-Event header, not in the body:

{
  "org_id": "5f0c...",
  "period": "2026-09",
  "threshold_pct": 100,
  "levels_crossed": [80, 100],
  "budget_usd": 500.0,
  "spend_usd": 512.3456,
  "unpriced_event_count": 0
}

unpriced_event_count counts calls this month that could not be priced and so are not in spend_usd.

Headers and signature

Every delivery carries:

• •X-Tokeven-Event - the event type, e.g. budget.threshold_crossed
• •X-Tokeven-Delivery-Id - an ID for the delivery, unchanged across retries, so you can deduplicate
• •X-Tokeven-Signature - sha256= followed by the hex HMAC-SHA256 of the raw request body, keyed with your endpoint's signing secret

Endpoints created with the n8n or Zapier preset also get the same signature in X-N8N-Webhook-Signature or X-Zapier-Webhook-Signature. Verify the signature against the raw body before trusting a delivery. Failed deliveries are retried with exponential backoff.

Using it in n8n

There is no dedicated Tokeven node. Use n8n's Webhook trigger node as the endpoint URL, then route the event into Slack, Teams, email or a ticketing workflow.