Create a thread

Mirrors the widget’s createThread helper.

POST /api/threads

cURL

curl --request POST \
  --url 'https://api.example.com/api/threads' \
  --header 'x-widget-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "subject": "Replacement tent pole set",
  "message": "Two-person tent, green — replacement for damaged pole set.",
  "channel": "string",
  "meta": {},
  "provider": "string"
}'

200

{
  "thread": {},
  "messages": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "sender": "string",
      "text": "Two-person tent, green — replacement for damaged pole set.",
      "timestamp": "2026-08-31T14:22:05Z"
    }
  ]
}

Mirrors the widget’s createThread helper.

Request body

ThreadCreate

subject · string · required

message · string

channel · string

meta · object

provider · string

Response

ThreadWithMessages

thread · object · required

messages · Message[] · required

Show Message

id · string

sender · string

text · string

timestamp · string (date-time)

Status codes

Code	Meaning
200	OK
400	Error
401	Error

cURL

curl --request POST \
  --url 'https://api.example.com/api/threads' \
  --header 'x-widget-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "subject": "Replacement tent pole set",
  "message": "Two-person tent, green — replacement for damaged pole set.",
  "channel": "string",
  "meta": {},
  "provider": "string"
}'

200

{
  "thread": {},
  "messages": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "sender": "string",
      "text": "Two-person tent, green — replacement for damaged pole set.",
      "timestamp": "2026-08-31T14:22:05Z"
    }
  ]
}