Developer

Webhooks

Receive notifications when users connect to or disconnect from avatar sessions

For LLMs

Overview

Configure a webhook URL to receive notifications when users connect to or disconnect from avatar sessions.

Configuration

Log in to your Trulience account
Click Developer in the navigation bar
Go to the API Keys tab
Configure your Webhook URL and optional Custom Headers

Webhook Events

Once configured, your webhook URL will receive POST requests for the following session events:

Event: session.connect - Triggered when a user connects to an avatar session

Event: session.disconnect - Triggered when a user disconnects from an avatar session

Webhook Payload

{
  "event_type": "session.connect",
  "customer_id": 100018,
  "avatar_id": "4386676996480451678",
  "session_id": "abc123xyz",
  "timestamp": "2026-01-29T12:00:00Z",
  "max_session_duration": 300
}

Field	Type	Description
`event_type`	string	Either `session.connect` or `session.disconnect`
`customer_id`	integer	Your customer ID
`avatar_id`	string	Avatar ID for this session
`session_id`	string	Unique session identifier
`timestamp`	string	ISO 8601 timestamp (UTC)
`max_session_duration`	integer	Maximum session duration in seconds. Only included for `session.connect` events when the avatar has a “Max Session Duration” limit configured