Create New Conversation

POST

/api/v1/accounts/{account_id}/conversations

Creating a conversation in chatwoot requires a source id.

Learn more about source_id: https://github.com/chatwoot/chatwoot/wiki/Building-on-Top-of-Chatwoot:-Importing-Existing-Contacts-and-Creating-Conversations

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/v1/accounts//conversations' \
--header 'Content-Type: application/json; charset=utf-8' \
--data-raw '{
    "source_id": "string",
    "inbox_id": "string",
    "contact_id": "string",
    "additional_attributes": {},
    "custom_attributes": {
        "attribute_key": "attribute_value",
        "priority_conversation_number": 3
    },
    "status": "open",
    "assignee_id": "string",
    "team_id": "string",
    "message": {
        "content": "string",
        "template_params": {
            "name": "sample_issue_resolution",
            "category": "UTILITY",
            "language": "en_US",
            "processed_params": {
                "1": "Chatwoot"
            }
        }
    }
}'

Response Example

200 - Example 1

{
    "id": 0,
    "account_id": 0,
    "inbox_id": 0
}

Request

Path Params

Body Params application/json; charset=utf-8

Examples

Responses

🟢200OK

application/json; charset=utf-8

Success

Body

🟠403Forbidden

Modified at 2025-05-15 10:23:41

Conversations List

Conversations Filter