---
title: "Create Conversation"
method: POST
path: "/conversations"
tags: ["Conversations"]
---

# Create Conversation

`POST /conversations`

Create a new conversation.

Required scopes:
+ **post**
+ **conversate**

## Request body

- object
  - `recipient_id` integer — Id of recipient. Required if **is_group=false**.
  - `recipients` string[] — List of recipients username's. Max recipients count is 10. Required if **is_group=true**.
  - `is_group` boolean — Is group. Set **false** if personal conversation, or set **true** if group.
  - `title` string — The title of new conversation. Required if **is_group=1**.
  - `open_invite` boolean — Open invite.
  - `allow_edit_messages` boolean — Allow edit messages.
  - `allow_sticky_messages` boolean — Allow members to stick messages.
  - `allow_delete_own_messages` boolean — Allow members to delete their own messages.
  - `message_body` string — First message. Required if **is_group**=false

## Response `200`

Successful Response.

- object
  - `conversation` RespConversationModel, required
    - `conversation_id` integer, required
    - `conversation_title` string, required
    - `creator_user_id` integer, required
    - `creator_username` string, required
    - `creator_username_html` string, required
    - `conversation_create_date` integer, required
    - `conversation_update_date` integer, required
    - `conversation_last_read_date` integer, required
    - `conversation_online_count` integer, required
    - `is_starred` integer, required
    - `is_group` integer, required
    - `is_unread` integer, required
    - `alerts` integer, required
    - `permissions` object, required
      - `view` boolean, required
      - `reply` boolean, required
      - `invite` boolean, required
      - `manage_invite_links` boolean, required
      - `kick` boolean, required
      - `upload_avatar` boolean, required
      - `editOwnPost` boolean, required
      - `stickyMessages` boolean, required
    - `conversation_message_count` integer, required
    - `conversation_is_new` boolean, required
    - `creator_is_ignored` boolean, required
    - `conversation_is_open` boolean, required
    - `conversation_is_deleted` boolean, required
    - `recipient` object, required
      - `user_id` integer, required
      - `username` string, required
      - `username_html` string, required
      - `last_activity` integer, required
      - `is_online` boolean, required
      - `contacts_changed` boolean, required
      - `avatar` string, required
    - `recipients` object[], required
      - `user_id` integer, required
      - `username` string, required
      - `username_html` string, required
      - `last_activity` integer, required
      - `is_online` boolean, required
      - `contacts_changed` boolean, required
      - `avatar` string, required
    - `links` object, required
      - `permalink` string, required
      - `detail` string, required
      - `messages` string, required
      - `avatar` string, required
  - `system_info` RespSystemInfo, required
    - `visitor_id` integer, required
    - `time` integer, required
    - `log_id` integer, required

## Other responses

- `401` — Unauthorized
- `403` — Error Response.
- `404` — Not Found

---

[API](https://skmtc.net/lolz/apis/lolzteam-public-api-forum.md) · [All operations](https://skmtc.net/lolz/apis/lolzteam-public-api-forum/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lolz/lolzteam-public-api-forum/versions/3efcdbc40994/schema)