---
title: "Submit Contact Form"
method: POST
path: "/api/livechat/public/{widget_key}/contact-form"
tags: ["livechat", "livechat"]
---

# Submit Contact Form

`POST /api/livechat/public/{widget_key}/contact-form`

## 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}/contact-form`
- Auth: none declared. Required headers: `X-Session-Token`

Submit contact information from inline form.

This endpoint is called when a visitor submits the contact form
that was displayed as part of a "form" decision type response.

The submitted info is:
1. Creates/links person record (using same logic as /identify)
2. Updates thread title from "Chat with Visitor xxx" to actual name
3. Notifies the sales team via WebSocket

## Path parameters

- `widget_key` string, required

## Headers

- `X-Session-Token` string, required

## Request body

- ContactFormRequest: Request to submit contact form from widget.
  - `message_id` string, required
  - `fields` object, required
  - `field_schema` object[], nullable

## Response `200`

Successful Response

- ContactFormResponse: Response after form submission.
  - `success` boolean, required
  - `message` string

## 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)