# Conversation State

## Updated

`com.twilio.conversations.conversation-state.updated`

Conversation State 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-state.updated",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Conversations.ConversationStateUpdated/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "AccountSid" : "ACe95cfd541a925a3337fec19a0200009",
    "ConversationSid" : "CHee95cfd541a925a3337fec19a0200009",
    "StateUpdated" : "2025-01-01T00:00:00.000Z",
    "StateFrom" : "active",
    "StateTo" : "inactive",
    "Reason" : "API",
    "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` **ConversationSid**. SID of the conversation. For example: CHee95cfd541a925a3337fec19a0200009.
* `string` **StateUpdated**. Date when the Conversation state was modified in ISO 8601 format.
* `string` **StateFrom**. The previous state of the conversation prior to the update (active, inactive or closed).
* `string` **StateTo**. The state the conversation was updated to (active, inactive or closed).
* `string` **Reason**. Source of the state change (API, TIMER, EVENT).
* `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.ConversationStateUpdated/2).

#### v1

* `string` **AccountSid**. Account SID of the conversation. For example: ACe95cfd541a925a3337fec19a0200009.
* `string` **ConversationSid**. SID of the conversation. For example: CHee95cfd541a925a3337fec19a0200009.
* `string` **StateUpdated**. Date when the Conversation state was modified in ISO 8601 format.
* `string` **StateFrom**. The previous state of the conversation prior to the update (active, inactive or closed).
* `string` **StateTo**. The state the conversation was updated to (active, inactive or closed).
* `string` **Reason**. Source of the state change (API, TIMER, EVENT).
* `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.ConversationStateUpdated/1).