---
title: "Create a new conversation with the list of participants in your account's default service"
method: POST
path: "/v1/Services/{ChatServiceSid}/ConversationWithParticipants"
tags: ["ConversationsV1ConversationWithParticipants"]
---

# Create a new conversation with the list of participants in your account's default service

`POST /v1/Services/{ChatServiceSid}/ConversationWithParticipants`

## Request

- Base URL: `https://conversations.twilio.com`
- URL: `https://conversations.twilio.com/v1/Services/{ChatServiceSid}/ConversationWithParticipants`
- Auth: HTTP basic

Create a new conversation with the list of participants in your account's default service

## Path parameters

- `ChatServiceSid` string, required

## Headers

- `X-Twilio-Webhook-Enabled` 'true' | 'false'

## Request body `application/x-www-form-urlencoded`

- object
  - `FriendlyName` string: The human-readable name of this conversation, limited to 256 characters. Optional.
  - `UniqueName` string: An application-defined string that uniquely identifies the resource. It can be used to address the resource in place of the resource's `sid` in the URL.
  - `DateCreated` string, date-time: The date that this resource was created.
  - `DateUpdated` string, date-time: The date that this resource was last updated.
  - `MessagingServiceSid` string: The unique ID of the [Messaging Service](https://www.twilio.com/docs/messaging/api/service-resource) this conversation belongs to.
  - `Attributes` string: An optional string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified. **Note** that if the attributes are not set "{}" will be returned.
  - `State` 'initializing' | 'inactive' | 'active' | 'closed': Current state of this conversation. Can be either `initializing`, `active`, `inactive` or `closed` and defaults to `active`
  - `Timers.Inactive` string: ISO8601 duration when conversation will be switched to `inactive` state. Minimum value for this timer is 1 minute.
  - `Timers.Closed` string: ISO8601 duration when conversation will be switched to `closed` state. Minimum value for this timer is 10 minutes.
  - `Bindings.Email.Address` string: The default email address that will be used when sending outbound emails in this conversation.
  - `Bindings.Email.Name` string: The default name that will be used when sending outbound emails in this conversation.
  - `Participant` string[]: The participant to be added to the conversation in JSON format. The JSON object attributes are as parameters in [Participant Resource](https://www.twilio.com/docs/conversations/api/conversation-participant-resource). The maximum number of participants that can be added in a single request is 10.

## Response `201`

Created

- ConversationsV1ServiceServiceConversationWithParticipants
  - `account_sid` string, nullable: The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this conversation.
  - `chat_service_sid` string, nullable: The unique ID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) this conversation belongs to.
  - `messaging_service_sid` string, nullable: The unique ID of the [Messaging Service](https://www.twilio.com/docs/messaging/api/service-resource) this conversation belongs to.
  - `sid` string, nullable: A 34 character string that uniquely identifies this resource.
  - `friendly_name` string, nullable: The human-readable name of this conversation, limited to 256 characters. Optional.
  - `unique_name` string, nullable: An application-defined string that uniquely identifies the resource. It can be used to address the resource in place of the resource's `sid` in the URL.
  - `attributes` string, nullable: An optional string metadata field you can use to store any data you wish. The string value must contain structurally valid JSON if specified. **Note** that if the attributes are not set "{}" will be returned.
  - `state` 'initializing' | 'inactive' | 'active' | 'closed': Current state of this conversation. Can be either `initializing`, `active`, `inactive` or `closed` and defaults to `active`
  - `date_created` string, date-time, nullable: The date that this resource was created.
  - `date_updated` string, date-time, nullable: The date that this resource was last updated.
  - `timers` unknown
  - `links` object, nullable: Contains absolute URLs to access the [participants](https://www.twilio.com/docs/conversations/api/conversation-participant-resource), [messages](https://www.twilio.com/docs/conversations/api/conversation-message-resource) and [webhooks](https://www.twilio.com/docs/conversations/api/conversation-scoped-webhook-resource) of this conversation.
  - `bindings` unknown
  - `url` string, uri, nullable: An absolute API resource URL for this conversation.

## Other responses

- `202`: Accepted

## Changes

- **2025-08-18** (v1) `7c6893e0ba68`: 2 warning, 1 info
  - added the new `initializing` enum value to the `state` response property for the response status `201`
  - added the new `initializing` enum value to the `state` response property for the response status `202`
  - added the new `initializing` enum value to the request property `State`
- **2025-07-03** (v1) `92d1169c37c2`: 4 breaking
  - the `bindings` response's property type changed from `object` to no type for status `201`
  - the `bindings` response's property type changed from `object` to no type for status `202`
  - the `timers` response's property type changed from `object` to no type for status `201`
  - the `timers` response's property type changed from `object` to no type for status `202`
- **2025-03-11** (v1) `b4d0e634cd69`: 4 breaking
  - the `bindings` response's property type changed from no type to `object` for status `201`
  - the `bindings` response's property type changed from no type to `object` for status `202`
  - the `timers` response's property type changed from no type to `object` for status `201`
  - the `timers` response's property type changed from no type to `object` for status `202`
- **2024-10-24** (v1) `a3c99e0ba886`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/twilio/apis/conversations-v1/changes/v1/Services/:ChatServiceSid/ConversationWithParticipants/post.md)

---

[API](https://skmtc.dev/twilio/apis/conversations-v1.md) - [All operations](https://skmtc.dev/twilio/apis/conversations-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/conversations-v1/revisions/6a37056c7727?raw)