---
title: "Create new chat"
method: POST
path: "/{scope_id}/chats"
---

# Create new chat

`POST /{scope_id}/chats`

This method allows you to create a chat before sending the first message.

## Path parameters

- `scope_id` string, required

## Headers

- `Date` string, required
- `Content-type` 'application/json', required
- `Content-MD5` string, required
- `X-Signature` string, required

## Request body

- object
  - `conversation_id` string, required — Chat ID on the integration side (your integration should generate it, it can be a phone number, a username)
  - `source` object
    - `external_id` string — Identifier of the chat source on the integration side. If you do not need to specify the source, then the source field does not need to be passed.
  - `user` object
    - `id` string, required — Chat participant ID on the integration side ( you generate the ID)
    - `name` string, required — Chat participant name
    - `avatar` string — Url to the chat participant avatar, Url should be available for download
    - `profile` object
      - `phone` string — Phone number. When creating an incoming lead, the phone number will be added to the contact data
      - `email` string — Email address. When creating an incoming lead, the email address will be added to the contact data
  - `profile_link` string — Url to the chat participant profile

## Response `200`

200

- object
  - `id` string
  - `user` object
    - `id` string
    - `client_id` string
    - `name` string
    - `avatar` string
    - `phone` string
    - `email` string

## Other responses

- `400` — 400
- `403` — 403
- `404` — 404

---

[API](https://skmtc.net/kommo/apis/kommo-api-references.md) · [All operations](https://skmtc.net/kommo/apis/kommo-api-references/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kommo/kommo-api-references/revisions/f17af4d23c7c/schema)