# Flow

## Execution Ended

`com.twilio.studio.flow.execution.ended`

Flow Execution Ended 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/studio/rest-api/v2/execution).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.studio.flow.execution.ended",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Studio.FlowExecutionEvent/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "execution_sid" : "FN0000000000000000000000000000001",
    "account_sid" : "AC0000000000000000000000000000001",
    "flow_sid" : "FW0000000000000000000000000000001",
    "contact_channel_address" : "+11234567890",
    "status" : "ended",
    "ended_reason" : "FLOW_END",
    "date_created" : "2025-01-01T00:00:00.000Z",
    "date_updated" : "2025-01-01T00:00:01.000Z",
    "started_by" : "CA0000000000000000000000000000001",
    "flow_revision" : 1196
  }
}
```

**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` **execution\_sid** (required). Execution SID from Event.
* `string` **account\_sid** (required). Account SID from Event.
* `string` **flow\_sid** (required). Flow SID from Event.
* `string` **contact\_channel\_address** (required). Address of contact channel.
* `string` **status** (required). Execution Status.
* `string` **ended\_reason**. Reason to end execution.
* `string` **date\_created** (required). Execution creation date.
* `string` **date\_updated**. Date updated for execution event.
* `string` **started\_by** (required). SID of the resource that initiated the Execution.
* `integer` **flow\_revision** (required). Revision number of the Flow that was used to handle this Execution.

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

#### v1

* `string` **execution\_sid** (required). Execution SID from Event.
* `string` **account\_sid** (required). Account SID from Event.
* `string` **flow\_sid** (required). Flow SID from Event.
* `string` **contact\_channel\_address** (required). Address of contact channel.
* `string` **status** (required). Execution Status.
* `string` **ended\_reason**. Reason to end execution.
* `string` **date\_created** (required). Execution creation date.
* `string` **date\_updated**. Date updated for execution event.
* `string` **started\_by** (required). SID of the resource that initiated the Execution.
* `integer` **flow\_revision** (required). Revision number of the Flow that was used to handle this Execution.

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

## Execution Started

`com.twilio.studio.flow.execution.started`

Flow Execution Started 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/studio/rest-api/v2/execution).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.studio.flow.execution.started",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Studio.FlowExecutionEvent/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "execution_sid" : "FN0000000000000000000000000000001",
    "account_sid" : "AC0000000000000000000000000000001",
    "flow_sid" : "FW0000000000000000000000000000001",
    "contact_channel_address" : "+11234567890",
    "status" : "ended",
    "ended_reason" : "FLOW_END",
    "date_created" : "2025-01-01T00:00:00.000Z",
    "date_updated" : "2025-01-01T00:00:01.000Z",
    "started_by" : "CA0000000000000000000000000000001",
    "flow_revision" : 1196
  }
}
```

**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` **execution\_sid** (required). Execution SID from Event.
* `string` **account\_sid** (required). Account SID from Event.
* `string` **flow\_sid** (required). Flow SID from Event.
* `string` **contact\_channel\_address** (required). Address of contact channel.
* `string` **status** (required). Execution Status.
* `string` **ended\_reason**. Reason to end execution.
* `string` **date\_created** (required). Execution creation date.
* `string` **date\_updated**. Date updated for execution event.
* `string` **started\_by** (required). SID of the resource that initiated the Execution.
* `integer` **flow\_revision** (required). Revision number of the Flow that was used to handle this Execution.

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

#### v1

* `string` **execution\_sid** (required). Execution SID from Event.
* `string` **account\_sid** (required). Account SID from Event.
* `string` **flow\_sid** (required). Flow SID from Event.
* `string` **contact\_channel\_address** (required). Address of contact channel.
* `string` **status** (required). Execution Status.
* `string` **ended\_reason**. Reason to end execution.
* `string` **date\_created** (required). Execution creation date.
* `string` **date\_updated**. Date updated for execution event.
* `string` **started\_by** (required). SID of the resource that initiated the Execution.
* `integer` **flow\_revision** (required). Revision number of the Flow that was used to handle this Execution.

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

## Step Ended

`com.twilio.studio.flow.step.ended`

Flow Step Ended 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/studio/rest-api/v2/step).

**Examples**

```json
{
  "specversion" : "1.0",
  "type" : "com.twilio.studio.flow.step.ended",
  "source" : "AB00000000000000000000000001",
  "id" : "NO00000000000000000000000001",
  "dataschema" : "https://events-schemas.twilio.com/Studio.FlowStepEvent/2",
  "datacontenttype" : "2025-10-08T07:17:02.363Z",
  "data" : {
    "parent_step_sid" : "FT0000000000000000000000000000001",
    "step_sid" : "FT0000000000000000000000000000002",
    "execution_sid" : "FN0000000000000000000000000000001",
    "account_sid" : "AC0000000000000000000000000000001",
    "flow_sid" : "FW0000000000000000000000000000001",
    "name" : "success",
    "transitioned_from" : "widget_1",
    "transitioned_to" : "widget_3",
    "date_created" : "2025-01-01T00:00:00.000Z"
  }
}
```

**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` **parent\_step\_sid**. Parent Step SID from Event.
* `string` **step\_sid** (required). Step SID from Event.
* `string` **execution\_sid** (required). Execution SID from Event.
* `string` **account\_sid** (required). Account SID from Event.
* `string` **flow\_sid** (required). Flow SID from Event.
* `string` **name** (required). Name of Step from Event.
* `string` **transitioned\_from** (required). The Widget the flow transitioned from.
* `string` **transitioned\_to** (required). The Widget the flow transitioned to.
* `string` **date\_created** (required). Step creation date.

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

#### v1

* `string` **parent\_step\_sid**. Parent Step SID from Event.
* `string` **step\_sid** (required). Step SID from Event.
* `string` **execution\_sid** (required). Execution SID from Event.
* `string` **account\_sid** (required). Account SID from Event.
* `string` **flow\_sid** (required). Flow SID from Event.
* `string` **name** (required). Name of Step from Event.
* `string` **transitioned\_from** (required). Step that the event transitioned from.
* `string` **transitioned\_to** (required). Step that the event transitioned to.
* `string` **date\_created** (required). Step creation date.

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