---
title: "Init Widget Session"
method: POST
path: "/api/livechat/public/{widget_key}/init"
tags: ["livechat", "livechat"]
---

# Init Widget Session

`POST /api/livechat/public/{widget_key}/init`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/livechat/public/{widget_key}/init`
- Auth: none declared

Initialize widget session.

Called when widget loads. Creates or retrieves visitor entity and session.

Returns session_token for subsequent API calls.

## Path parameters

- `widget_key` string, required

## Request body

- WidgetInitRequest: Request to initialize widget session.
  - `visitor_id` string, nullable
  - `fingerprint` string, nullable
  - `page_url` string, nullable
  - `page_title` string, nullable
  - `referrer` string, nullable
  - `user_agent` string, nullable
  - `page_content` PageContent: Page content extracted from the widget's host page.
    - `url` string, required
    - `title` string, required
    - `description` string, nullable
    - `headings` string[]
    - `mainContent` string, nullable
    - `language` string, nullable
    - `timezone` string, nullable
  - `visitor_token` string, nullable

## Response `200`

Successful Response

- WidgetInitResponse: Response with session info.
  - `session_token` string, required
  - `visitor_id` string, required
  - `thread_id` string, nullable
  - `require_identification` boolean, required
  - `show_history` boolean, required
  - `widget_config` object, required
  - `visitor` object, nullable
  - `identified` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/77bef09a9209?raw)