Pushing customer events into Inquiru with the Events API
Updated June 14, 2026
What the Events API does
The Events API lets you push customer behaviour signals into Inquiru from your own systems (website, app, data warehouse, etc.). These events are surfaced to the agent as context alongside the conversation, enabling richer, more personalised responses.
Generating an API key
On the Events page, click Generate Key (or Regenerate if you already have one). Copy the key and store it securely — it is only shown in full once. Regenerating a key immediately invalidates the previous one.
Sending events
Send a POST request to /api/v1/events/ingest with the header X-Api-Key: <your-key> and a JSON body:
{ "customerId": "user_123", "eventType": "deposit", "source": "payment-service", "properties": { "amount": 500, "currency": "GBP" } }The customerId must match the customer ID attached to the conversation — set by your Zendesk integration or via Inquiru("identify", { userId }) for Live Chat sessions.
Viewing the event log
The Events page shows all received events with timestamps, customer IDs, event types, sources, and properties. Use the filters to search by customer ID or event type. Up to 50 events are shown per page.
How agents use events
The 20 most recent events for a customer are automatically included in the agent's context window when it processes a message. For example, if a customer just made a large deposit, the agent can reference this when answering questions about account balance or withdrawal limits.