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

# POST /conversations

`POST /conversations`

Allows the creation of a Conversation attached to a given object of Connect.


**WARNING! The creation of conversations is only available to CloudBlue Connect platform
modules and is done automatically for most of the business objects handled by CloudBlue
Connect. External actors can list conversations and add messages to existing ones but will
not be able to create new conversations.**

## Request body

- ConversationsConversation — Represents *Conversation* object. `id` -- id of the conversation. `instance_id` -- id of the object linked to the conversation (i.e. Helpdesk case, Fulfillment request, etc.). `topic` -- topic of the conversation. `type` -- conversation type. Can be one of `conversation` or `notes`. `status` -- status of the conversation. Can be one of `open` or `closed`. `events` -- the information about who and when created and/or updated the conversation. `accounts` -- information about partners which are involved into the conversation. `actor` -- information about the user who created / initiated the conversation. `created` -- the information about when was the conversation created.
  - `id` string
  - `instance_id` string, required
  - `topic` string, required
  - `type` 'conversation' | 'notes'
  - `status` 'open' | 'closed'
  - `events` object
    - `created` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `updated` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
  - `accounts` ConversationsAccount[], required
    - `id` string, required
    - `name` string
    - `icon` string, nullable
  - `creator` ConversationsActor — Connect Actor details. `id` -- id of the actor. `name` -- name of the actor. `icon` -- icon of the actor.
    - `id` string
    - `name` string
    - `icon` string
  - `created` string, date-time

## Response `201`

- ConversationsConversation — Represents *Conversation* object. `id` -- id of the conversation. `instance_id` -- id of the object linked to the conversation (i.e. Helpdesk case, Fulfillment request, etc.). `topic` -- topic of the conversation. `type` -- conversation type. Can be one of `conversation` or `notes`. `status` -- status of the conversation. Can be one of `open` or `closed`. `events` -- the information about who and when created and/or updated the conversation. `accounts` -- information about partners which are involved into the conversation. `actor` -- information about the user who created / initiated the conversation. `created` -- the information about when was the conversation created.
  - `id` string
  - `instance_id` string, required
  - `topic` string, required
  - `type` 'conversation' | 'notes'
  - `status` 'open' | 'closed'
  - `events` object
    - `created` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `updated` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
  - `accounts` ConversationsAccount[], required
    - `id` string, required
    - `name` string
    - `icon` string, nullable
  - `creator` ConversationsActor — Connect Actor details. `id` -- id of the actor. `name` -- name of the actor. `icon` -- icon of the actor.
    - `id` string
    - `name` string
    - `icon` string
  - `created` string, date-time

## Other responses

- `400`

---

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