# Create a new conversation with the list of participants in your account's default service **POST /v1/ConversationWithParticipants** Create a new conversation with the list of participants in your account's default service A Conversation resource represents an omnichannel group conversation with an ordered list of messages and a participant roster. ## Servers - https://conversations.twilio.com: https://conversations.twilio.com () ## Authentication methods - Account sid auth token ## Parameters ### Headers - **X-Twilio-Webhook-Enabled** (string) The X-Twilio-Webhook-Enabled HTTP request header ### 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** (string) 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** (array[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. ## Responses ### 201 Created #### Headers - **Access-Control-Allow-Origin** (string) Specify the origin(s) allowed to access the resource - **Access-Control-Allow-Methods** (string) Specify the HTTP methods allowed when accessing the resource - **Access-Control-Allow-Headers** (string) Specify the headers allowed when accessing the resource - **Access-Control-Allow-Credentials** (boolean) Indicates whether the browser should include credentials - **Access-Control-Expose-Headers** (string) Headers exposed to the client #### Body: application/json (object) - **account_sid** (string | null) The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this conversation. - **chat_service_sid** (string | null) The unique ID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) this conversation belongs to. - **messaging_service_sid** (string | null) The unique ID of the [Messaging Service](https://www.twilio.com/docs/messaging/api/service-resource) this conversation belongs to. - **sid** (string | null) A 34 character string that uniquely identifies this resource. - **friendly_name** (string | null) The human-readable name of this conversation, limited to 256 characters. Optional. - **unique_name** (string | null) 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 | null) 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** (string) Current state of this conversation. Can be either `initializing`, `active`, `inactive` or `closed` and defaults to `active` - **date_created** (string(date-time) | null) The date that this resource was created. - **date_updated** (string(date-time) | null) The date that this resource was last updated. - **timers** () Timer date values representing state update for this conversation. - **links** (object(uri-map) | null) 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** () - **url** (string(uri) | null) An absolute API resource URL for this conversation. ### 202 Accepted #### Headers - **Access-Control-Allow-Origin** (string) Specify the origin(s) allowed to access the resource - **Access-Control-Allow-Methods** (string) Specify the HTTP methods allowed when accessing the resource - **Access-Control-Allow-Headers** (string) Specify the headers allowed when accessing the resource - **Access-Control-Allow-Credentials** (boolean) Indicates whether the browser should include credentials - **Access-Control-Expose-Headers** (string) Headers exposed to the client #### Body: application/json (object) - **account_sid** (string | null) The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) responsible for this conversation. - **chat_service_sid** (string | null) The unique ID of the [Conversation Service](https://www.twilio.com/docs/conversations/api/service-resource) this conversation belongs to. - **messaging_service_sid** (string | null) The unique ID of the [Messaging Service](https://www.twilio.com/docs/messaging/api/service-resource) this conversation belongs to. - **sid** (string | null) A 34 character string that uniquely identifies this resource. - **friendly_name** (string | null) The human-readable name of this conversation, limited to 256 characters. Optional. - **unique_name** (string | null) 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 | null) 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** (string) Current state of this conversation. Can be either `initializing`, `active`, `inactive` or `closed` and defaults to `active` - **date_created** (string(date-time) | null) The date that this resource was created. - **date_updated** (string(date-time) | null) The date that this resource was last updated. - **timers** () Timer date values representing state update for this conversation. - **links** (object(uri-map) | null) 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** () - **url** (string(uri) | null) An absolute API resource URL for this conversation. [Powered by Bump.sh](https://bump.sh)