# Participant

## Added

`com.twilio.conversations.participant.added`

Participant 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-participant-resource).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.conversations.participant.added",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Conversations.ParticipantAdded/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "AccountSid" : "ACe95cfd541a925a3337fec19a0200009",
    "ParticipantSid" : "MB0119bde8f8b74237a4606d1447c9ebcf",
    "Identity" : "FX0000000000000000000000000000001",
    "RoleSid" : "RLe95cfd541a925a3337fec19a0200009",
    "ConversationSid" : "CHee95cfd541a925a3337fec19a0200009",
    "DateCreated" : "2025-01-01T00:00:00.000Z",
    "MessagingBinding" : {
      "ProxyAddress" : "whatsapp:+11234567890",
      "ProjectedAddress" : "[whatsapp:+12345678901]",
      "Address" : "whatsapp:+14567890123",
      "Type" : "SMS",
      "Level" : "cc",
      "Name" : "John Doe"
    }
  }
}
```

**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` **ParticipantSid**. SID of the participant. For example: MB0119bde8f8b74237a4606d1447c9ebcf.
* `object` **Attributes**. Conversation metadata as set by the customer.
* `string` **Identity**. Identity of the user being added to the conversation.
* `string` **RoleSid**. Role SID of the user being added to the conversation. For example: RLe95cfd541a925a3337fec19a0200009.
* `string` **ConversationSid**. SID of the conversation this participant is in. For example: CHee95cfd541a925a3337fec19a0200009.
* `string` **DateCreated**. Creation date of the participant in ISO 8601 format.
* `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` **Address**. Originating phone number of the channel creator.
  * `string` **Type**. Type of the participant, one of: SMS, CHAT, WHATSAPP.
  * `string` **Level**. Address level of the Messaging binding for the participant.
  * `string` **Name**. Address name of the Messaging binding for the participant.

The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/Conversations.ParticipantAdded/2).

#### v1

* `string` **AccountSid**. Account SID of the conversation. For example: ACe95cfd541a925a3337fec19a0200009.
* `string` **ParticipantSid**. Account SID of the participant. For example: ACe95cfd541a925a3337fec19a0200009.
* `object` **Attributes**. Conversation metadata as set by the customer.
* `string` **Identity**. Identity of the user being added to the conversation.
* `string` **RoleSid**. Role SID of the user being added to the conversation. For example: RLe95cfd541a925a3337fec19a0200009.
* `string` **ConversationSid**. SID of the conversation this participant is in. For example: CHee95cfd541a925a3337fec19a0200009.
* `string` **DateCreated**. Creation date of the participant in ISO 8601 format.
* `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` **Address**. Originating phone number of the channel creator.
  * `string` **Type**. Type of the participant, one of: SMS, CHAT, WHATSAPP.
  * `string` **Level**. Address level of the Messaging binding for the participant.
  * `string` **Name**. Address name of the Messaging binding for the participant.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/Conversations.ParticipantAdded/1).

## Removed

`com.twilio.conversations.participant.removed`

Participant 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-participant-resource).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.conversations.participant.removed",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Conversations.ParticipantRemoved/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "AccountSid" : "ACe95cfd541a925a3337fec19a0200009",
    "ParticipantSid" : "ACe95cfd541a925a3337fec19a0200009",
    "Identity" : "FX0000000000000000000000000000001",
    "RoleSid" : "RLe95cfd541a925a3337fec19a0200009",
    "ConversationSid" : "CHee95cfd541a925a3337fec19a0200009",
    "DateCreated" : "2025-01-01T00:00:00.000Z",
    "DateUpdated" : "2025-01-01T00:00:01.000Z",
    "DateRemoved" : "2025-01-01T00:01:00.000Z",
    "MessagingBinding" : {
      "ProxyAddress" : "whatsapp:+11234567890",
      "ProjectedAddress" : "[whatsapp:+12345678901]",
      "Address" : "whatsapp:+14567890123",
      "Type" : "SMS",
      "Level" : "cc",
      "Name" : "John Doe"
    }
  }
}
```

**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` **ParticipantSid**. Account SID of the participant. For example: ACe95cfd541a925a3337fec19a0200009.
* `object` **Attributes**. Conversation metadata as set by the customer.
* `string` **Identity**. Identity of the user being removed from the conversation.
* `string` **RoleSid**. Role SID of the user being removed from the conversation. For example: RLe95cfd541a925a3337fec19a0200009.
* `string` **ConversationSid**. SID of the conversation. For example: CHee95cfd541a925a3337fec19a0200009.
* `string` **DateCreated**. Creation date of the participant in ISO 8601 format.
* `string` **DateUpdated**. Update date of the participant in ISO 8601 format.
* `string` **DateRemoved**. Removal date of the participant in ISO 8601 format.
* `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` **Address**. Originating phone number of the channel creator.
  * `string` **Type**. Type of the participant, one of: SMS, CHAT, WHATSAPP.
  * `string` **Level**. Address level of the Messaging binding for the participant.
  * `string` **Name**. Address name of the Messaging binding for the participant.

The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/Conversations.ParticipantRemoved/2).

#### v1

* `string` **AccountSid**. Account SID of the event owner. For example: ACe95cfd541a925a3337fec19a0200009.
* `string` **ParticipantSid**. Account SID of the participant. For example: ACe95cfd541a925a3337fec19a0200009.
* `object` **Attributes**. Conversation metadata as set by the customer.
* `string` **Identity**. Identity of the user being removed from the conversation.
* `string` **RoleSid**. Role SID of the user being removed from the conversation. For example: RLe95cfd541a925a3337fec19a0200009.
* `string` **ConversationSid**. SID of the conversation. For example: CHee95cfd541a925a3337fec19a0200009.
* `string` **DateCreated**. Creation date of the participant in ISO 8601 format.
* `string` **DateUpdated**. Update date of the participant in ISO 8601 format.
* `string` **DateRemoved**. Removal date of the participant in ISO 8601 format.
* `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` **Address**. Originating phone number of the channel creator.
  * `string` **Type**. Type of the participant, one of: SMS, CHAT, WHATSAPP.
  * `string` **Level**. Address level of the Messaging binding for the participant.
  * `string` **Name**. Address name of the Messaging binding for the participant.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/Conversations.ParticipantRemoved/1).

## Updated

`com.twilio.conversations.participant.updated`

Participant 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-participant-resource).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.conversations.participant.updated",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Conversations.ParticipantUpdated/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "AccountSid" : "ACe95cfd541a925a3337fec19a0200009",
    "ParticipantSid" : "ACe95cfd541a925a3337fec19a0200009",
    "Identity" : "FX0000000000000000000000000000001",
    "RoleSid" : "RLe95cfd541a925a3337fec19a0200009",
    "ConversationSid" : "CHee95cfd541a925a3337fec19a0200009",
    "DateCreated" : "2025-01-01T00:00:00.000Z",
    "DateUpdated" : "2025-01-01T00:00:01.000Z",
    "MessagingBinding" : {
      "ProxyAddress" : "whatsapp:+11234567890",
      "ProjectedAddress" : "[whatsapp:+12345678901]",
      "Address" : "whatsapp:+14567890123",
      "Type" : "SMS",
      "Level" : "cc",
      "Name" : "John Doe"
    }
  }
}
```

**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` **ParticipantSid**. Account SID of the participant. For example: ACe95cfd541a925a3337fec19a0200009.
* `object` **Attributes**. Conversation metadata as set by the customer.
* `string` **Identity**. Identity of the user being updated in the conversation.
* `string` **RoleSid**. Role SID of the user being updated in the conversation. For example: RLe95cfd541a925a3337fec19a0200009.
* `string` **ConversationSid**. SID of the conversation. For example: CHee95cfd541a925a3337fec19a0200009.
* `string` **DateCreated**. Creation date of the participant in ISO 8601 format.
* `string` **DateUpdated**. Update date of the participant in ISO 8601 format.
* `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` **Address**. Originating phone number of the channel creator.
  * `string` **Type**. Type of the participant, one of: SMS, CHAT, WHATSAPP.
  * `string` **Level**. Address level of the Messaging binding for the participant.
  * `string` **Name**. Address name of the Messaging binding for the participant.

The full specification for version 2 is also available as a [JSON schema](https://events-schemas.twilio.com/Conversations.ParticipantUpdated/2).

#### v1

* `string` **AccountSid**. Account SID of the conversation. For example: ACe95cfd541a925a3337fec19a0200009.
* `string` **ParticipantSid**. Account SID of the participant. For example: ACe95cfd541a925a3337fec19a0200009.
* `object` **Attributes**. Conversation metadata as set by the customer.
* `string` **Identity**. Identity of the user being updated in the conversation.
* `string` **RoleSid**. Role SID of the user being updated in the conversation. For example: RLe95cfd541a925a3337fec19a0200009.
* `string` **ConversationSid**. SID of the conversation. For example: CHee95cfd541a925a3337fec19a0200009.
* `string` **DateCreated**. Creation date of the participant in ISO 8601 format.
* `string` **DateUpdated**. Update date of the participant in ISO 8601 format.
* `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` **Address**. Originating phone number of the channel creator.
  * `string` **Type**. Type of the participant, one of: SMS, CHAT, WHATSAPP.
  * `string` **Level**. Address level of the Messaging binding for the participant.
  * `string` **Name**. Address name of the Messaging binding for the participant.

The full specification for version 1 is also available as a [JSON schema](https://events-schemas.twilio.com/Conversations.ParticipantUpdated/1).