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

# Creates conversation

`POST /1.0/conversations`

## Request

- Base URL: `https://api.rocketlane.com/api`
- URL: `https://api.rocketlane.com/api/1.0/conversations`
- Auth: API key in header `api-key`
- TypeScript: <https://skmtc.dev/rocketlane/apis/rocketlane-api/docs/1.0/conversations/post.ts> (a function with typed inputs; its response is checked against the schema)

The Create Conversation API allows users to initiate a new conversation within a specified project using its unique project ID. This endpoint facilitates seamless communication by enabling teams to start discussions, share updates, and collaborate effectively within the project workspace. Upon a successful request, the API returns the newly created conversation details, including metadata such as participants, timestamps, and initial message content.

## Query parameters

- `includeFields` string[]
- `includeAllFields` boolean

## Request body

- ConversationPublicRequestAPIEntity
  - `name` string, required: Conversation name
  - `description` string: Conversation description
  - `source` ConversationSourcePublicAPIRequestEntity, required: Source associated with the conversation
    - `sourceId` integer, required: Source Id attached to the conversation
    - `sourceType` 'PROJECT_CONVERSATION', required: Source Type attached to the conversation
  - `allMembers` boolean: Conversation all members inclusion
  - `members` ConversationMemberPublicAPIRequestEntity[]: Conversation members
    - `emailId` string: The team members email identifier.
    - `userId` integer: The unique identifier for the user.
    - `firstName` string: The first name of the user.
    - `lastName` string: The last name of the user.
  - `private` boolean: Conversation privacy

## Response `200`

The requested action was successfully executed.

- ConversationPublicResponseAPIEntity: Reflects all the default and custom fields and their values for the object searched, in an array format. If the includeFields param is utilised in the request body, it will return a customised response.
  - `conversationName` string: Conversation name
  - `description` string: Conversation description
  - `allMembers` boolean: Conversation all members inclusion
  - `members` ConversationMemberPublicAPIEntity[]: Conversation members
    - `emailId` string: Email ID
    - `userId` integer: User ID
    - `firstName` string: First name
    - `lastName` string: Last name
  - `source` ConverationSourcePublicAPIResponseEntity: Source associated with the conversation
    - `sourceId` integer: Source Id attached to the conversation
    - `sourceType` 'PROJECT_CONVERSATION': Source Type attached to the conversation
  - `conversationId` integer: Conversation ID
  - `createdAt` integer: Conversation Created timestamp
  - `private` boolean: Conversation privacy

## Other responses

- `400`: This error typically happens when the request payload contains an error. If you want to make sure that the request's parameters are named correctly and are the right data types, you can examine the request's syntax.
- `401`: You see this error when trying to access this resource without being authenticated. Check the API request header to make sure it is not empty and has a valid api-key that you acquired from the Rocketlane API Settings tab.
- `404`: If we were unable to locate the resource you were looking for or the proper API endpoint you were looking for, this error would show up.

## Changes

- **2026-11-03** `a002a499e6fc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rocketlane/apis/rocketlane-api/changes/1.0/conversations/post.md)

---

[API](https://skmtc.dev/rocketlane/apis/rocketlane-api.md) - [All operations](https://skmtc.dev/rocketlane/apis/rocketlane-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rocketlane/apis/rocketlane-api/revisions/a002a499e6fc?raw)