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 or Kinesis quickstarts and refer to the product documentation.

Examples

1{
2  "specversion" : "1.0",
3  "type" : "com.twilio.conversations.conversation.added",
4  "source" : "AB00000000000000000000000001",
5  "id" : "NO00000000000000000000000001",
6  "dataschema" : "https://events-schemas.twilio.com/Conversations.ConversationAdded/2",
7  "datacontenttype" : "2025-10-08T07:17:02.363Z",
8  "data" : {
9    "AccountSid" : "ACe95cfd541a925a3337fec19a0200009",
10    "FriendlyName" : "whatsapp:+11234567890",
11    "UniqueName" : "My conversation with +11234567890",
12    "State" : "active",
13    "ConversationSid" : "CHee95cfd541a925a3337fec19a0200009",
14    "DateCreated" : "2025-01-01T00:00:00.000Z",
15    "MessagingServiceSid" : "MGee95cfd541a925a3337fec19a0200009",
16    "MessageBody" : "Ahoy!",
17    "MessageSubject" : "Welcome to Twilio",
18    "MessagingBinding" : {
19      "ProxyAddress" : "whatsapp:+11234567890",
20      "ProjectedAddress" : "[whatsapp:+12345678901]",
21      "AuthorAddress" : "whatsapp:+13456789012",
22      "Address" : "whatsapp:+14567890123"
23    },
24    "Bindings" : {
25      "Email" : {
26        "ProjectedAddress" : "info@mycompany.com",
27        "Name" : "Support at MyCompany"
28      }
29    },
30    "AuthorFriendlyName" : "My friendly name",
31    "Media" : [
32      {
33        "MediaSid" : "ME0000000000000000000000000000001",
34        "Filename" : "00000000-0000-0000-0000-000000000000.png",
35        "ContentType" : "image/png",
36        "Size" : 12232
37      }
38    ]
39  }
40}

Versions

v2 (latest)

(information)

Info

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.

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 or Kinesis quickstarts and refer to the product documentation.

Examples

1{
2  "specversion" : "1.0",
3  "type" : "com.twilio.conversations.conversation.removed",
4  "source" : "AB00000000000000000000000001",
5  "id" : "NO00000000000000000000000001",
6  "dataschema" : "https://events-schemas.twilio.com/Conversations.ConversationRemoved/2",
7  "datacontenttype" : "2025-10-08T07:17:02.363Z",
8  "data" : {
9    "AccountSid" : "ACe95cfd541a925a3337fec19a0200009",
10    "FriendlyName" : "whatsapp:+11234567890",
11    "UniqueName" : "My conversation with +11234567890",
12    "State" : "active",
13    "ConversationSid" : "CHee95cfd541a925a3337fec19a0200009",
14    "DateCreated" : "2025-01-01T00:00:00.000Z",
15    "DateUpdated" : "2025-01-01T00:00:01.000Z",
16    "DateRemoved" : "2025-01-01T00:01:00.000Z",
17    "MessagingServiceSid" : "MGee95cfd541a925a3337fec19a0200009"
18  }
19}

Versions

v2 (latest)

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 or Kinesis quickstarts and refer to the product documentation.

Examples

1{
2  "specversion" : "1.0",
3  "type" : "com.twilio.conversations.conversation.updated",
4  "source" : "AB00000000000000000000000001",
5  "id" : "NO00000000000000000000000001",
6  "dataschema" : "https://events-schemas.twilio.com/Conversations.ConversationUpdated/2",
7  "datacontenttype" : "2025-10-08T07:17:02.363Z",
8  "data" : {
9    "AccountSid" : "ACe95cfd541a925a3337fec19a0200009",
10    "FriendlyName" : "whatsapp:+11234567890",
11    "UniqueName" : "My conversation with +11234567890",
12    "State" : "active",
13    "ConversationSid" : "CHee95cfd541a925a3337fec19a0200009",
14    "DateCreated" : "2025-01-01T00:00:00.000Z",
15    "DateUpdated" : "2025-01-01T00:00:01.000Z",
16    "MessagingServiceSid" : "MGee95cfd541a925a3337fec19a0200009"
17  }
18}

Versions

v2 (latest)