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

# Create new chat

`POST /{scope_id}/chats`

## Request

- Base URL: `https://amojo.kommo.com/v2/origin/custom`
- URL: `https://amojo.kommo.com/v2/origin/custom/{scope_id}/chats`
- Auth: none required

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.dev/kommo/apis/chats-api.md) - [All operations](https://skmtc.dev/kommo/apis/chats-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kommo/apis/chats-api/revisions/174554fdf536?raw)