Webhooks

Base URL: https://app.lisn.dev/api

When a webhook_url is configured on an assistant, the system sends a POST request with the analysis results after processing completes.

Webhook Payload

{
  "event": "session.completed",
  "session_id": "ses_987654321",
  "assistant_id": "ast_abc123",
  "status": "completed",
  "summary_text": "Customer called to inquire about...",
  "raw_response": { "..." : "..." },
  "total_cost": 0.05,
  "created_at": "2026-03-08T14:30:00Z"
}

Authentication

If you configured a webhook_secret, the system includes it as a Bearer token:

POST /your/webhook/endpoint HTTP/1.1
Content-Type: application/json
Authorization: Bearer YOUR_WEBHOOK_SECRET
X-Webhook-Event: session.completed
X-Webhook-Delivery: del_abc123

Retry Policy

Failed deliveries are retried up to 3 times with exponential backoff:

Attempt	Delay
1st retry	30 seconds
2nd retry	2 minutes
3rd retry	10 minutes

Delivery logs are available via the Sessions & Logs page.

Response Format Errors