# Create a conversation.

**POST /api/v1/conversation**




## Servers
- https://api.plannrcrm.com: https://api.plannrcrm.com ()


## Authentication methods
- Personal access token & O auth2


## Parameters
### Headers
- **X-PLANNR-ACCOUNT-UUID** (string)




### Body: application/json (object)

- **name** (string)
  Conversation title
- **case** (string(uuid))
  Case UUID to assign this conversation to
- **participants** (array)
  Account UUIDs belonging to the firm
- **message** (string)
  Contents of first message to be created alongside the conversation.


## Responses
### 200


#### Body: application/json (object)
- **uuid** (string)
  The UUID of the resource.
- **created_at** (string)
  The timestamp of when the resource was created.
- **updated_at** (string)
  The timestamp of when the resource was updated.
- **name** (string)
  Conversation title
- **slug** (string)
  Conversation title as a slug
- **belongs_to_case** (boolean)
  Whether or not the conversation belongs to a case.
- **case** (object)
  Case the conversation belongs to (if included)
- **participants_count** (integer)
  Number of participants in conversation (if included)
- **participants** (array[object])
  Participants in this conversation (if included)
- **latest_message** (object)
  The latest message of the conversation (if included)
- **messages_count** (integer)
  Number of messages in the conversation (if included)
- **files_count** (integer)
  Number of files in the conversation (if included)
- **tags** (array[object])
  Conversation tags (if included)
- **pinned** (boolean)
  Whether the conversation has been pinned to the top (if participants included)
- **is_admin** (boolean)
  If the authenticated account is an admin of the conversation (if participants included)


[Powered by Bump.sh](https://bump.sh)