# Message

## Added

`com.twilio.conversations.message.added`

Message 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-message-resource).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.conversations.message.added",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Conversations.MessageAdded/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "AccountSid" : "ACe95cfd541a925a3337fec19a0200009",
    "Author" : "system",
    "ParticipantSid" : "MBe95cfd541a925a3337fec19a0200009",
    "ConversationSid" : "CHee95cfd541a925a3337fec19a0200009",
    "MessageSid" : "IMee95cfd541a925a3337fec19a0200009",
    "Index" : 10,
    "MessageBody" : "Ahoy!",
    "DateCreated" : "2025-01-01T00:00:00.000Z",
    "MessageSubject" : "Welcome to Twilio",
    "MessagingServiceSid" : "MGee95cfd541a925a3337fec19a0200009",
    "ContentSid" : "HXee95cfd541a925a3337fec19a0200009",
    "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 event owner. For example: ACe95cfd541a925a3337fec19a0200009.
* `string` **Author**. The channel specific identifier of the message's author. Defaults to system.
* `string` **ParticipantSid**. Participant SID of the message author. Null in case of system sent message. For example: MBe95cfd541a925a3337fec19a0200009.
* `object` **Attributes**. Conversation metadata as set by the customer.
* `string` **ConversationSid**. SID of the conversation. For example: CHee95cfd541a925a3337fec19a0200009.
* `string` **MessageSid**. SID of the Conversation message. For example: IMee95cfd541a925a3337fec19a0200009.
* `integer` **Index**. Message index in the messages stream.
* `string` **MessageBody**. The body of the message.
* `string` **DateCreated**. Creation date of the message in ISO 8601 format.
* `string` **MessageSubject**. Subject of the conversation message.
* `string` **MessagingServiceSid**. SID of the messaging service. For example: MGee95cfd541a925a3337fec19a0200009.
* `string` **ContentSid**. The unique ID of the multi-channel Rich Content template. For example: HXee95cfd541a925a3337fec19a0200009.
* `object[]` **Media**. Media properties of the message 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.MessageAdded/2).

#### v1

* `string` **AccountSid**. Account SID of the event owner. For example: ACe95cfd541a925a3337fec19a0200009.
* `string` **Author**. The channel specific identifier of the message's author. Defaults to system.
* `string` **ParticipantSid**. Participant SID of the message author. Null in case of system sent message. For example: MBe95cfd541a925a3337fec19a0200009.
* `object` **Attributes**. Conversation metadata as set by the customer.
* `string` **ConversationSid**. SID of the conversation. For example: CHee95cfd541a925a3337fec19a0200009.
* `string` **MessageSid**. SID of the Conversation message. For example: IMee95cfd541a925a3337fec19a0200009.
* `integer` **Index**. Message index in the messages stream.
* `string` **MessageBody**. The body of the message.
* `string` **DateCreated**. Creation date of the message in ISO 8601 format.
* `string` **MessageSubject**. Subject of the conversation message.
* `string` **MessagingServiceSid**. SID of the messaging service. For example: MGee95cfd541a925a3337fec19a0200009.
* `string` **ContentSid**. The unique ID of the multi-channel Rich Content template. For example: HXee95cfd541a925a3337fec19a0200009.
* `object[]` **Media**. Media properties of the message 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.MessageAdded/1).

## Removed

`com.twilio.conversations.message.removed`

Message 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-message-resource).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.conversations.message.removed",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Conversations.MessageRemoved/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "AccountSid" : "ACe95cfd541a925a3337fec19a0200009",
    "Author" : "system",
    "ParticipantSid" : "MBe95cfd541a925a3337fec19a0200009",
    "ConversationSid" : "CHee95cfd541a925a3337fec19a0200009",
    "MessageSid" : "IMee95cfd541a925a3337fec19a0200009",
    "Index" : 10,
    "MessageBody" : "Ahoy!",
    "DateCreated" : "2025-01-01T00:00:00.000Z",
    "DateUpdated" : "2025-01-01T00:00:00.000Z",
    "DateRemoved" : "2025-01-01T00:00:00.000Z",
    "MessageSubject" : "Welcome to Twilio",
    "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 event owner. For example: ACe95cfd541a925a3337fec19a0200009.
* `string` **Author**. The channel specific identifier of the message's author. Defaults to system.
* `string` **ParticipantSid**. Participant SID of the message author. Null in case of system sent message. For example: MBe95cfd541a925a3337fec19a0200009.
* `object` **Attributes**. Conversation metadata as set by the customer.
* `string` **ConversationSid**. SID of the conversation. For example: CHee95cfd541a925a3337fec19a0200009.
* `string` **MessageSid**. SID of the Conversation message. For example: IMee95cfd541a925a3337fec19a0200009.
* `integer` **Index**. Message index in the messages stream.
* `string` **MessageBody**. The body of the message.
* `string` **DateCreated**. Creation date of the message in ISO 8601 format.
* `string` **DateUpdated**. Update date of the message in ISO 8601 format.
* `string` **DateRemoved**. Removal date of the message in ISO 8601 format.
* `string` **MessageSubject**. Subject of the conversation message.
* `object[]` **Media**. Media properties of the message 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.MessageRemoved/2).

#### v1

* `string` **AccountSid**. Account SID of the event owner. For example: ACe95cfd541a925a3337fec19a0200009.
* `string` **Author**. The channel specific identifier of the message's author. Defaults to system.
* `string` **ParticipantSid**. Participant SID of the message author. Null in case of system sent message. For example: MBe95cfd541a925a3337fec19a0200009.
* `object` **Attributes**. Conversation metadata as set by the customer.
* `string` **ConversationSid**. SID of the conversation. For example: CHee95cfd541a925a3337fec19a0200009.
* `string` **MessageSid**. SID of the Conversation message. For example: IMee95cfd541a925a3337fec19a0200009.
* `integer` **Index**. Message index in the messages stream.
* `string` **MessageBody**. The body of the message.
* `string` **DateCreated**. Creation date of the message in ISO 8601 format.
* `string` **DateUpdated**. Update date of the message in ISO 8601 format.
* `string` **DateRemoved**. Removal date of the message in ISO 8601 format.
* `string` **MessageSubject**. Subject of the conversation message.
* `object[]` **Media**. Media properties of the message 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.MessageRemoved/1).

## Updated

`com.twilio.conversations.message.updated`

Message 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-message-resource).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.conversations.message.updated",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Conversations.MessageUpdated/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "AccountSid" : "ACe95cfd541a925a3337fec19a0200009",
    "Author" : "system",
    "ParticipantSid" : "MBe95cfd541a925a3337fec19a0200009",
    "ConversationSid" : "CHee95cfd541a925a3337fec19a0200009",
    "MessageSid" : "IMee95cfd541a925a3337fec19a0200009",
    "Index" : 10,
    "MessageBody" : "Ahoy!",
    "DateCreated" : "2025-01-01T00:00:00.000Z",
    "DateUpdated" : "2025-01-01T00:00:01.000Z",
    "MessageSubject" : "Welcome to Twilio!",
    "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 event owner. For example: ACe95cfd541a925a3337fec19a0200009.
* `string` **Author**. The channel specific identifier of the message's author. Defaults to system.
* `string` **ParticipantSid**. Participant SID of the message author. Null in case of system sent message. For example: MBe95cfd541a925a3337fec19a0200009.
* `object` **Attributes**. Conversation metadata as set by the customer.
* `string` **ConversationSid**. SID of the conversation. For example: CHee95cfd541a925a3337fec19a0200009.
* `string` **MessageSid**. SID of the Conversation message. For example: IMee95cfd541a925a3337fec19a0200009.
* `integer` **Index**. Message index in the messages stream.
* `string` **MessageBody**. The body of the message.
* `string` **DateCreated**. Creation date of the message in ISO 8601 format.
* `string` **DateUpdated**. Update date of the message in ISO 8601 format.
* `string` **MessageSubject**. Subject of the conversation message.
* `object[]` **Media**. Media properties of the message 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.MessageUpdated/2).

#### v1

* `string` **AccountSid**. Account SID of the event owner. For example: ACe95cfd541a925a3337fec19a0200009.
* `string` **Author**. The channel specific identifier of the message's author. Defaults to system.
* `string` **ParticipantSid**. Participant SID of the message author. Null in case of system sent message. For example: MBe95cfd541a925a3337fec19a0200009.
* `object` **Attributes**. Conversation metadata as set by the customer.
* `string` **ConversationSid**. SID of the conversation. For example: CHee95cfd541a925a3337fec19a0200009.
* `string` **MessageSid**. SID of the Conversation message. For example: IMee95cfd541a925a3337fec19a0200009.
* `integer` **Index**. Message index in the messages stream.
* `string` **MessageBody**. The body of the message.
* `string` **DateCreated**. Creation date of the message in ISO 8601 format.
* `string` **DateUpdated**. Update date of the message in ISO 8601 format.
* `string` **MessageSubject**. Subject of the conversation message.
* `object[]` **Media**. Media properties of the message 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.MessageUpdated/1).