Webhooks

Receive real-time notifications for usage events. Available on Builder and Scale plans.

Setup

Configure outbound webhooks in Dashboard → Webhooks. Provide a URL and select the events you want to receive. PathFinder sends POST requests to your URL for each subscribed event.

Verification

Every delivery includes an HMAC-SHA256 signature in the X-PathFinder-Signature header. Verify it against the webhook secret shown in your dashboard to confirm the request is authentic.

Example payload

usage event:

{
  "event": "usage",
  "model": "claude-sonnet-4",
  "provider": "anthropic",
  "taskType": "coding",
  "tokensIn": 150,
  "tokensOut": 420,
  "costUsd": 0.0078,
  "routingFeeUsd": 0.0004,
  "timestamp": "2026-04-05T12:34:56.789Z"
}

Retries

Failed deliveries are retried up to 3 times with exponential backoff. Delivery history (including HTTP status and errors) is visible in the dashboard.