Helicone

Ingest logs from Helicone into Igris for unified compliance and audit.

Helicone Integration

Helicone is an open-source LLM observability platform. Send Helicone webhook events to Igris to include LLM call data in your unified audit trail.

Setup

1. Get Your Igris API Key

Go to Settings → API Keys in the Igris dashboard and create a new key labeled “Helicone Ingestion”.

2. Configure Helicone Webhook

In your Helicone dashboard, navigate to Webhooks and create a new webhook:

• URL: https://your-igris.fly.dev/api/v1/ingest/helicone
• Headers:
  Authorization: Bearer ig_your_api_key_here
  Content-Type: application/json
  
• Events: Select the event types you want forwarded

3. Verify

Make an LLM call through Helicone’s proxy and confirm the event appears in Observe → Audit Events with source: helicone.

Payload Normalization

Helicone Field	Igris Field
request.model	toolName
response.status	action (2xx → allow, other → deny)
request_id	metadata.requestId
request.prompt_tokens	metadata.promptTokens
response.completion_tokens	metadata.completionTokens
delay_ms	metadata.latencyMs
created_at	timestamp

Example Event

{
  "id": "evt_def456",
  "orgId": "org_xyz",
  "source": "helicone",
  "type": "completion",
  "toolName": "claude-sonnet-4-20250514",
  "action": "allow",
  "metadata": {
    "requestId": "req_789",
    "promptTokens": 200,
    "completionTokens": 450,
    "latencyMs": 890
  },
  "timestamp": "2026-03-19T11:00:00.000Z"
}

Troubleshooting

Issue	Solution
Events not appearing	Verify webhook URL, API key, and that events are enabled in Helicone
401 Unauthorized	Regenerate the API key and update the webhook header
429 Too Many Requests	Upgrade your Igris plan for higher event limits