Skip to main content
POST
/
public
/
api
/
v1
/
inboxes
/
{inbox_identifier}
/
contacts
/
{contact_identifier}
/
conversations
Create a conversation
curl --request POST \
  --url https://app.chatwoot.com/public/api/v1/inboxes/{inbox_identifier}/contacts/{contact_identifier}/conversations \
  --header 'Content-Type: application/json' \
  --data '
{
  "custom_attributes": {}
}
'
{
  "id": 123,
  "inbox_id": "<string>",
  "messages": [
    {
      "id": 123,
      "content": "<string>",
      "account_id": 123,
      "inbox_id": 123,
      "conversation_id": 123,
      "message_type": 0,
      "created_at": 123,
      "updated_at": 123,
      "private": true,
      "status": "sent",
      "source_id": "<string>",
      "content_type": "text",
      "content_attributes": {},
      "sender_type": "contact",
      "sender_id": 123,
      "external_source_ids": {},
      "additional_attributes": {},
      "processed_message_content": "<string>",
      "sentiment": {},
      "conversation": {},
      "attachment": {},
      "sender": {}
    }
  ],
  "contact": {}
}

Documentation Index

Fetch the complete documentation index at: https://developers.chatwoot.com/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

​
inbox_identifier
string
required

The identifier obtained from API inbox channel

​
contact_identifier
string
required

The source id of contact obtained on contact create

Body

application/json
​
custom_attributes
object

Custom attributes of the conversation

Example:
{}

Response

Success

​
id
integer

Id of the conversation

​
inbox_id
string

The inbox id of the conversation

​
messages
object[]

Messages in the conversation

​
contact
object

The contact information associated to the conversation