Create Conversation

Updated about 2 hours ago•1 min read

POST

/v1/conversations

Creates a new conversation thread on behalf of a customer in the specified inbox.

Parameters

Name	Type	Description
`inbox_id`required	string	Target inbox UUID
`customer_id`required	string	Customer UUID
`status`	string	Initial status: 'active', 'closed', 'snoozed', 'resolved'
`priority`	string	Priority: 'low', 'medium', 'high', 'urgent'

Responses

200Conversation created successfully

{
  "data": {
    "id": "cnv_778",
    "identifier": "CNV-1030",
    "status": "active",
    "priority": "medium",
    "inbox_id": "inb_901",
    "created_at": "2026-09-02T14:15:00Z"
  }
}