# Conversation ## Added `com.twilio.conversations.conversation.added` Conversation Added events are compatible with Webhook and Kinesis sinks. To learn more, you can get started with the [Webhook](/docs/events/webhook-quickstart) or [Kinesis](/docs/events/eventstreams-quickstart) quickstarts and refer to the [product documentation](/docs/conversations/api/conversation-resource). **Examples** ```json { "specversion" : "1.0", "type" : "com.twilio.conversations.conversation.added", "source" : "AB00000000000000000000000001", "id" : "NO00000000000000000000000001", "dataschema" : "https://events-schemas.twilio.com/Conversations.ConversationAdded/2", "datacontenttype" : "2025-10-08T07:17:02.363Z", "data" : { "AccountSid" : "ACe95cfd541a925a3337fec19a0200009", "FriendlyName" : "whatsapp:+11234567890", "UniqueName" : "My conversation with +11234567890", "State" : "active", "ConversationSid" : "CHee95cfd541a925a3337fec19a0200009", "DateCreated" : "2025-01-01T00:00:00.000Z", "MessagingServiceSid" : "MGee95cfd541a925a3337fec19a0200009", "MessageBody" : "Ahoy!", "MessageSubject" : "Welcome to Twilio", "MessagingBinding" : { "ProxyAddress" : "whatsapp:+11234567890", "ProjectedAddress" : "[whatsapp:+12345678901]", "AuthorAddress" : "whatsapp:+13456789012", "Address" : "whatsapp:+14567890123" }, "Bindings" : { "Email" : { "ProjectedAddress" : "info@mycompany.com", "Name" : "Support at MyCompany" } }, "AuthorFriendlyName" : "My friendly name", "Media" : [ { "MediaSid" : "ME0000000000000000000000000000001", "Filename" : "00000000-0000-0000-0000-000000000000.png", "ContentType" : "image/png", "Size" : 12232 } ] } } ``` **Versions** #### v2 (latest) > \[!NOTE] > > v2 only contains updates to the schema metadata. In other words, there are no new fields between v1 and v2. * `string` **AccountSid**. Account SID of the conversation. For example: ACe95cfd541a925a3337fec19a0200009. * `string` **FriendlyName**. Friendly name of the conversation. * `string` **UniqueName**. Unique name of the conversation. * `object` **Attributes**. Conversation metadata as set by the customer. * `string` **State**. Enumerated type representing state of the conversation. Possible values are: active, inactive, closed. * `string` **ConversationSid**. SID of the conversation. For example: CHee95cfd541a925a3337fec19a0200009. * `string` **DateCreated**. Creation date of the conversation in ISO 8601 format. * `string` **MessagingServiceSid**. SID of the messaging service. For example: MGee95cfd541a925a3337fec19a0200009. * `string` **MessageBody**. Initial conversation message string. * `string` **MessageSubject**. Subject of the initial conversation message. * `object` **MessagingBinding**. Object containing Messaging binding values. * `string` **ProxyAddress**. Twilio Brand phone number used by channel creator. * `string` **ProjectedAddress**. The address of the Twilio phone number that is used in Group MMS. Communication mask for the Conversation participant with Identity. * `string` **AuthorAddress**. Number of the message author when auto-creating Group MMS. * `string` **Address**. Originating phone number of the channel creator. * `object` **Bindings**. Object containing bindings values. * `object` **Email**. Object containing email bindings values. * `string` **ProjectedAddress**. The default email address that will be used when sending outbound emails in this conversation. * `string` **Name**. The default name that will be used when sending outbound emails in this conversation. * `string` **AuthorFriendlyName**. Friendly name of the author. * `object[]` **Media**. Media properties of the conversation as an array of JSON objects. * `string` **MediaSid**. SID of the media object. * `string` **Filename**. Filename of the media object. * `string` **ContentType**. Content type of the media object. * `integer` **Size**. Size of the media object in bytes. The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/Conversations.ConversationAdded/2). #### v1 * `string` **AccountSid**. Account SID of the conversation. For example: ACe95cfd541a925a3337fec19a0200009. * `string` **FriendlyName**. Friendly name of the conversation. * `string` **UniqueName**. Unique name of the conversation. * `object` **Attributes**. Conversation metadata as set by the customer. * `string` **State**. Enumerated type representing state of the conversation. Possible values are: active, inactive, closed. * `string` **ConversationSid**. SID of the conversation. For example: CHee95cfd541a925a3337fec19a0200009. * `string` **DateCreated**. Creation date of the conversation in ISO 8601 format. * `string` **MessagingServiceSid**. SID of the messaging service. For example: MGee95cfd541a925a3337fec19a0200009. * `string` **MessageBody**. Initial conversation message string. * `string` **MessageSubject**. Subject of the initial conversation message. * `object` **MessagingBinding**. Object containing Messaging binding values. * `string` **ProxyAddress**. Twilio Brand phone number used by channel creator. * `string` **ProjectedAddress**. The address of the Twilio phone number that is used in Group MMS. Communication mask for the Conversation participant with Identity. * `string` **AuthorAddress**. Number of the message author when auto-creating Group MMS. * `string` **Address**. Originating phone number of the channel creator. * `object` **Bindings**. Object containing bindings values. * `object` **Email**. Object containing email bindings values. * `string` **ProjectedAddress**. The default email address that will be used when sending outbound emails in this conversation. * `string` **Name**. The default name that will be used when sending outbound emails in this conversation. * `string` **AuthorFriendlyName**. Friendly name of the author. * `object[]` **Media**. Media properties of the conversation as an array of JSON objects. * `string` **MediaSid**. SID of the media object. * `string` **Filename**. Filename of the media object. * `string` **ContentType**. Content type of the media object. * `integer` **Size**. Size of the media object in bytes. The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/Conversations.ConversationAdded/1). ## Removed `com.twilio.conversations.conversation.removed` Conversation Removed events are compatible with Webhook and Kinesis sinks. To learn more, you can get started with the [Webhook](/docs/events/webhook-quickstart) or [Kinesis](/docs/events/eventstreams-quickstart) quickstarts and refer to the [product documentation](/docs/conversations/api/conversation-resource). **Examples** ```json { "specversion" : "1.0", "type" : "com.twilio.conversations.conversation.removed", "source" : "AB00000000000000000000000001", "id" : "NO00000000000000000000000001", "dataschema" : "https://events-schemas.twilio.com/Conversations.ConversationRemoved/2", "datacontenttype" : "2025-10-08T07:17:02.363Z", "data" : { "AccountSid" : "ACe95cfd541a925a3337fec19a0200009", "FriendlyName" : "whatsapp:+11234567890", "UniqueName" : "My conversation with +11234567890", "State" : "active", "ConversationSid" : "CHee95cfd541a925a3337fec19a0200009", "DateCreated" : "2025-01-01T00:00:00.000Z", "DateUpdated" : "2025-01-01T00:00:01.000Z", "DateRemoved" : "2025-01-01T00:01:00.000Z", "MessagingServiceSid" : "MGee95cfd541a925a3337fec19a0200009" } } ``` **Versions** #### v2 (latest) > \[!NOTE] > > v2 only contains updates to the schema metadata. In other words, there are no new fields between v1 and v2. * `string` **AccountSid**. Account SID of the conversation. For example: ACe95cfd541a925a3337fec19a0200009. * `string` **FriendlyName**. Friendly name of the conversation. * `string` **UniqueName**. Unique name of the conversation. * `object` **Attributes**. Conversation metadata as set by the customer. * `string` **State**. Enumerated type representing state of the conversation. Possible values are: active, inactive, closed. * `string` **ConversationSid**. SID of the conversation. For example: CHee95cfd541a925a3337fec19a0200009. * `string` **DateCreated**. Creation date of the conversation in ISO 8601 format. * `string` **DateUpdated**. Update date of the conversation in ISO 8601 format. * `string` **DateRemoved**. Removal date of the conversation in ISO 8601 format. * `string` **MessagingServiceSid**. SID of the messaging service. For example: MGee95cfd541a925a3337fec19a0200009. The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/Conversations.ConversationRemoved/2). #### v1 * `string` **AccountSid**. Account SID of the conversation. For example: ACe95cfd541a925a3337fec19a0200009. * `string` **FriendlyName**. Friendly name of the conversation. * `string` **UniqueName**. Unique name of the conversation. * `object` **Attributes**. Conversation metadata as set by the customer. * `string` **State**. Enumerated type representing state of the conversation. Possible values are: active, inactive, closed. * `string` **ConversationSid**. SID of the conversation. For example: CHee95cfd541a925a3337fec19a0200009. * `string` **DateCreated**. Creation date of the conversation in ISO 8601 format. * `string` **DateUpdated**. Update date of the conversation in ISO 8601 format. * `string` **DateRemoved**. Removal date of the conversation in ISO 8601 format. * `string` **MessagingServiceSid**. SID of the messaging service. For example: MGee95cfd541a925a3337fec19a0200009. The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/Conversations.ConversationRemoved/1). ## Updated `com.twilio.conversations.conversation.updated` Conversation Updated events are compatible with Webhook and Kinesis sinks. To learn more, you can get started with the [Webhook](/docs/events/webhook-quickstart) or [Kinesis](/docs/events/eventstreams-quickstart) quickstarts and refer to the [product documentation](/docs/conversations/api/conversation-resource). **Examples** ```json { "specversion" : "1.0", "type" : "com.twilio.conversations.conversation.updated", "source" : "AB00000000000000000000000001", "id" : "NO00000000000000000000000001", "dataschema" : "https://events-schemas.twilio.com/Conversations.ConversationUpdated/2", "datacontenttype" : "2025-10-08T07:17:02.363Z", "data" : { "AccountSid" : "ACe95cfd541a925a3337fec19a0200009", "FriendlyName" : "whatsapp:+11234567890", "UniqueName" : "My conversation with +11234567890", "State" : "active", "ConversationSid" : "CHee95cfd541a925a3337fec19a0200009", "DateCreated" : "2025-01-01T00:00:00.000Z", "DateUpdated" : "2025-01-01T00:00:01.000Z", "MessagingServiceSid" : "MGee95cfd541a925a3337fec19a0200009" } } ``` **Versions** #### v2 (latest) > \[!NOTE] > > v2 only contains updates to the schema metadata. In other words, there are no new fields between v1 and v2. * `string` **AccountSid**. Account SID of the conversation. For example: ACe95cfd541a925a3337fec19a0200009. * `string` **FriendlyName**. Friendly name of the conversation. * `string` **UniqueName**. Unique name of the conversation. * `object` **Attributes**. Conversation metadata as set by the customer. * `string` **State**. Enumerated type representing state of the conversation. Possible values are: active, inactive, closed. * `string` **ConversationSid**. SID of the conversation. For example: CHee95cfd541a925a3337fec19a0200009. * `string` **DateCreated**. Creation date of the conversation in ISO 8601 format. * `string` **DateUpdated**. Update date of the conversation in ISO 8601 format. * `string` **MessagingServiceSid**. SID of the messaging service. For example: MGee95cfd541a925a3337fec19a0200009. The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/Conversations.ConversationUpdated/2). #### v1 * `string` **AccountSid**. Account SID of the conversation. For example: ACe95cfd541a925a3337fec19a0200009. * `string` **FriendlyName**. Friendly name of the conversation. * `string` **UniqueName**. Unique name of the conversation. * `object` **Attributes**. Conversation metadata as set by the customer. * `string` **State**. Enumerated type representing state of the conversation. Possible values are: active, inactive, closed. * `string` **ConversationSid**. SID of the conversation. For example: CHee95cfd541a925a3337fec19a0200009. * `string` **DateCreated**. Creation date of the conversation in ISO 8601 format. * `string` **DateUpdated**. Update date of the conversation in ISO 8601 format. * `string` **MessagingServiceSid**. SID of the messaging service. For example: MGee95cfd541a925a3337fec19a0200009. The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/Conversations.ConversationUpdated/1).