Skip to main content

​
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 FieldIgris Field
request.modeltoolName
response.statusaction (2xx → allow, other → deny)
request_idmetadata.requestId
request.prompt_tokensmetadata.promptTokens
response.completion_tokensmetadata.completionTokens
delay_msmetadata.latencyMs
created_attimestamp

​
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

IssueSolution
Events not appearingVerify webhook URL, API key, and that events are enabled in Helicone
401 UnauthorizedRegenerate the API key and update the webhook header
429 Too Many RequestsUpgrade your Igris plan for higher event limits