Start conversation
POST
/v1/conversationsAuth: Site public key (rk_pk_)
Create a new visitor conversation from the widget.
Body parameters
| Name | Type | Description |
|---|---|---|
sitePublicKeyrequired | string | rk_pk_… key |
visitorFingerprintrequired | string | Browser fingerprint |
visitorName | string | Optional display name |
visitorEmail | string | Optional email |
Responses
201New conversation
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"siteId": "660e8400-e29b-41d4-a716-446655440001",
"visitorId": "770e8400-e29b-41d4-a716-446655440002",
"status": "open",
"assigneeId": null,
"createdAt": "2026-01-15T10:00:00Z",
"updatedAt": "2026-01-15T10:05:00Z"
}