---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/events/event-types/conversations/conversation#article
headline: Conversation
description: List of Conversations event types regarding Conversation available in Twilio Event Streams, as well as their JSON schemas and examples.
url: https://www.twilio.com/docs/events/event-types/conversations/conversation
inLanguage: en
dateModified: 2026-10-12T19:18:47.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# 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-classic/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)](https://events-schemas.twilio.com/Conversations.ConversationAdded/2)
* [v1](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-classic/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)](https://events-schemas.twilio.com/Conversations.ConversationRemoved/2)
* [v1](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-classic/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)](https://events-schemas.twilio.com/Conversations.ConversationUpdated/2)
* [v1](https://events-schemas.twilio.com/Conversations.ConversationUpdated/1)